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BETT SHOW 


As last year, | spent some time wandering 
around the BETT Show which took place at the 
Barbican Exhibition Centre in London from 16th 
to 19th January (indeed, Beebug also had a 
stand at this show giving us the opportunity to 
meet and talk with many educational users). 


Overall, it was my impression that the 
proportion of the show occupied by Acorn and 
companies associated with Acorn, such as 
ourselves, was much the same as last year 
(when | was somewhat critical of Acorn). 
However, | thought that there was a different 
feel to this part of the show, and that was one 
of much greater substance and maturity. 


There is now a substantial range of software for 
the Archimedes, much of which is of interest to 
educational users (and to home users as well). 
There are still areas of weakness, and ample 
room for the development of further products, 
but in many application areas users now have a 
choice of at least three or four packages of 
quality, and in many cases applications are now 
into a second release, with the consequent bug 
fixing and refinement of the product which this 
implies. 


Acorn staff with whom | talked were quietly 
confident that the future for the Archimedes 
range is now assured, and that with sales of 
over 100,000 a critical mass in its further 
development has now been achieved. 


RISC USER MAGAZINE DISCS 


The RISC User magazine discs continue to prove 
very popular (a significant proportion of our 
readers purchase this regularly). It is worth 
repeating that not only do we endeavour to pack 
each monthly disc with additional bonus items, 
but that much technical effort is put into 
ensuring that all the software is tested and 
updated to make each disc as robust and reliable 


A 


as possible. In some cases, we substantially 
rewrite sections of ams to ensure that they 
perform as we think they should. 


The menu system contained on each disc 
provides general information about each 
program or application on the disc, and man 
applications include a Help or ReadMe file 
peek eter in the case of bonus items) with 
urther information. We do urge readers to 
make full use of the information provided in 
order to make the most of the software, and to 
ensure that all the requirements for running an 
application are known at the outset. 


CONTRIBUTIONS 


We are always keen to publish contributions 
from RISC User readers. Articles and programs 
(either for the magazine or for the magazine 
disc) are always welcome, but do try to make 
sure that you conform to the style and standard 
of other items in the magazine. 

Hints and Tips also form a very vital and valued 
part of the magazine, and your contributions 
here will be particularly appreciated. Lastly, your 
letters, with comments or queries on any matter 
relating to RISC User and the Archimedes, will 
often be of interest to others, and the best are 
featured in our Postbag and Technical 
Queries pages (indeed some of our articles 
come about because of feedback from readers). 


Do remember that we PAY for all articles and 
programs published in the magazine, or on the 


m disc, and for hints and tips. We hope 
to hear from you soon. 
ARCSCAN Iil 
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for Only 


A selection of | MARC THREE £ 9 95 
12 multi-tasking 3 Exciting New 


Desktop Applications Outline Fonts 


(Chancellor, Katiyo and Chinese) 


MARC ONE Desktop PC Disc Reader and 
© DataSheet — Data Presentation Package for cresting annotated graphs in Background Text Printer 


a variety of formats for display or printing. plus: 
® Calc_570 — Scientific Calculator, a Desktop Implementation of the Casio 
FXS70. @ Sticky BackDrop — places icons anywhere on th 

@ CharDes — Character Designer for creating new system fonts. desktop. 

© Diary — A multi-tasking Desktop Diary and calendar. ® Application Shell Generator for creating 

© B.to_T — Application Handler which allows programs to be edited without application directories, sprites and !Run files, 

leaving the Desktop. © Wimp Front End for the Basic Editor. 
© FileFind — File-find utility which performs hierarchical search for a given © Watchdog Anti-Virus — protect your hard and 
file, application or directory, floppy discs from viruses. 
@ SetType — Filetype Setter which you can use to change the filetype of any © Keystrip Generator (both 9- and 24- pin matrix 
file by dragging it to Use icon bar, printer versions). 
@ HotKeys — A Desktop hotkeys utility that allows single key presses to @ Encode — a file encryption utility 
perform a wide range of functions, ® CMOS RAM Manager 
@ Mouse — Mouse-speed Controller for changing the mouse speed merely by ®@ Ovation Clip-art — from Beebug’s highly successful DTP package Ovation. 
clicking on an icon. @ Amaze — a graphically superb and entertaining game. 
© Print — Multi-format Print Utility — @ A selection of the best Maestro music files. 
NORMAL MULTILAYER HISTOGRAM allows text and program files to be ® Advanced Desktop Presentation Creator — screen display with « choice 
feet printed just by dragging them to the of different fades, 
Pan icon bar. © Palette Files for Colour Printers. 
Pane © NotePad — A Desktop Notepad © A complete set of ArcScan index data 
gic: application which provides for up to for RISC User Magazine Volume 3, 
= eight pages of jottings. 


© Dustbin — Desktop Dustbin which 

sits on the icon bar and allows files to 
be deleted by simply dragging them to 
its icon. 


by David Spencer and Mike Williams 


A collection of 

7 Original Archimedes 
Games 
ArCOMNIBUS 


© Amaze — a graphically superb sliding block game 
with a difference, 

© Cribbage — an excellent implementation of the weil 
known card game, 

@ Moric — a colourful ‘ladders and levels’ game. 

© Ogre’s Lair — a highly entertaining arcade type 
game, providing hours of fun. 

@ Pick a Pair — a colourful game testing your skills of 
observation and memory, 

@ BalloonMan — burst the balloon — a Pacman style 
of game 

© Dominoes — a Desktop version of the classic game of 

dominoes. 


File Handling for All is a comprehensive book 
which covers all the requirements of data storage and 
processing by computer, using the popular BBC Basic 
programming language for the examples. It is aimed 
at anybody interested in File Handling and 
Databases, whether beginners or more advanced 
users, and will appeal to all who want to learn more 
of this important subject. 

The book starts with an introduction to the 
rudiments of file handling, and in the following 
chapters develops an in-depth look at the different 
types of files eg. serial files, indexed files, direct 
access files, and searching and sorting. A separate 
chapter is devoted to hierarchical and relational 
database design, and the book concludes with 
practical advice on developing file handling programs. 

‘The associated disc (£4.75) contains complete 
working programs based on the routines described in 
the book and a copy of Filer, a full-feature Database 


program. 
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Telephone: 0727 40303 Pease note postage for the discs it £1 for Europe and £240 vosiers 
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PORTABLE ARC 


Acorn is to produce a portable Archimedes, 
which will probably appear during the 
latter part of this year. Acorn has not 
released any details at all, but it seems 
certain that the portable will be a high 
specification professional computer, and not 
a budget model. It is rumoured that the 
machine will have an ARM3 processor as 
standard, a high-resolution film-retardant 
LCD monochrome screen and a built-in 
trackerball. A full colour version is likely to 
follow some time during 1992. We must 
stress, however, that none of these details 
have been confirmed by Acorn. 


SOFTWARE DEVELOPMENT 
ENVIRONMENT 


Delegates from 30 companies attended a 
seminar held by Acorn on software 
development in C for RISC OS. The 
delegates were chosen to be representative 
of the range of companies registered with 
Acorn as ISVs (Independent Software 
Vendors) and IHVs (Independent Hardware 
Vendors) who develop and market products 
for Acorn’s RISC OS hardware platforms. 
During the course of the day, a presentation 
was made of an integrated SDE (Software 
Development Environment) for RISC OS 
that is currently under development at 
Acorn. Acorn plans to release C and ARM 
Assembler products in the latter half of 
1991 which incorporate this environment. 
Acorn will be providing an upgrade 
mechanism for existing owners of Acorn’s 
current C and Assembler products, and 
details of this will be announced at product 
launch. Details of all Acorn products can be 
obtained from Acorn Computers Ltd., 
Fulbourn Road, Cherry Hinton, Cambridge 
CB1 4JN, tel. (0223) 245200. 


EXPANDED VISION 


Wild Vision has produced an expansion box 
which will allow standard Archimedes 
expansion cards to be used with the A3000. 
The box plugs into the rear expansion port, 
and accepts 2 full-width or 3 half-width 
cards, It has an external 12v power supply, 
and protection circuitry to prevent any 
damage to the computer from external 
supplies. The A3000 Expansion Box costs 
£159.85 inc. VAT, and Wild Vision is making 
a special introductory offer of the box 
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together with its Hawk V9 colour digitiser 
for £458.85. For further details, contact 
Wild Vision at 15 Witney Way, Boldon 
Business Park, Boldon Colliery, Tyne & 
Wear NE35 9PE, tel. 091-519 1455. 


COLOUR SCANNER FROM BEEBUG 


BEEBUG is about to release a colour 
scanner package for the Archimedes and 
A3000 based around the popular Sharp JX- 
100 scanner. The unit can scan an image of 
up to 160x100mm in 16 million colours. The 
supplied software converts this to a 256- 
colour RISC OS sprite that can be 
incorporated into DTP documents etc. The 
scanner package, which will be available in 
mid-March, consists of the JX-100 itself, a 
half-width interface card, disc-based 
software and a comprehensive user guide. 
An A3000 version will also be available 
which houses the interface card in an 
external metal case. The complete package 
will cost £665.85 inc. VAT for the 
Archimedes model, and £677.35 inc. VAT for 
the A3000 version. 


MIDNIGHT TRACER 


Midnight Graphics has released Tracer, a 
software package which enables you to 
convert sprite files into Draw format. Both 
colour and monochrome images can be 
processed, and the result is a fully editable 
object oriented file which can be 
manipulated easily within Draw. The 
package is particularly useful with 
scanners, digitisers, and other devices 
which produce bit-image pictures. Tracer 
costs £59.95 inc. VAT, and is available from 
Midnight Graphics, 5 Victoria Lane, 
Whitefield, Manchester M25 6AL, tel. 061- 
766 8423. 


VIRTUALLY ARMLESS 


At the time of writing, 30MHz ARM3 chips 
are in extremely short supply. It appears 
that VLSI is unable at present to 
manufacture the chips in the quantities 
needed. As a result, supplies of both the 
A540 and the ARM3 upgrades offered by 
various companies are being held up. 


DTP FOR EDUCATION 


Desktop Folio is a new package from ESM 
which has been designed to provide DTP 
and word processing facilities for 7-year- 
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SCSI HARD DISC 
DRIVES AND 
INTERFACES 

FOR THE A3000 


e From Only £398 

e Fast drives in a wide range of capacities 

@ Quality mechanisms (Seagate, Rodime, etc.) 

@ Metal case with power supply 

e Fully screened SCSI connectors and cable 

e Easily daisy-chained to provide multiple drives 


Beebug have launched a full range of SCSI hard disc drives for the s = 
A300 with capacities from 20Mbyte to 338Mbyte. These are all oe ED DRIVES: 
half-height quality drive mechanisms housed in an attractive case INCLUDING 43000 INTERFACE 

with an internal switch-mode power supply. Included in the price is stock code Capacity Price (ex. VAT) 
a high quality screened SCSI cable and an 8 bit SCSI interface, 5220 20Mbyte £398.00 
which fits neatly inside the A3000 module slot. This is supplied 5221 49Mbyte £498.00 
with full fitting instructions and may be fitted in minutes. No 5222 anidecr £598.00 
soldering or specialist skills are necessary. 5224 1 10Mbyte £798.00 


A number of drives may be daisy-chained together to give in- S25 183Mbyte P “ee 
creased capacity. All drives are supplied with through connectors 5225 338Mbyte 7 ‘ 
and the appropriate cables, but units in the middle of the chain re- Carriage is £8.00 per drive. Add 10 to stock code 
quire a set of terminating resistors to be removed. We can supply —_for drives without terminators (e.g 5220 becomes 
the drives with these already removed. See opposite for ordering = 5230). Drives are available without interface - 
details. deduct £99. 


ARM3 PROCESSOR CARD 


@ Massive speed increase Stock code: 0134 

e Riscware control software 

@ Comprehensive user guide £3 9 9 00 

e Compact design using latest ¢ 
surface mount technology (+ VAT + £5.50 Carriage) 

e Compatible with all software 


The ARM3 micro-processor is the latest in the series of Acorn RISC Machine reduced 
instruction set processors. It is the micro-processor fitted as standard to Acorn’s new 
flagship - the 540. 


This new card from Beebug allows a super-fast ARM3 processor running at 32 MHz fo be fitted to your Archimedes 300 or 400 
series computer, The highly compact circuit board measures just 55 by 60 mm (approx) and contains the latest surface mounted 
ARMS processor together with a clock generator circuit. 


The ARM3 Card is inserted in place of the existing ARM2 processor and provides a four-fold increase in processor clock speed 
along with a 4Kbyte cache which serves to isolate the fast processor from the relatively slow RAM. Average speed increases of 3 to 
5 times are typical, and unlike speed enhancers such as floating point co-processors, the ARM3 Card improves performance of all 
software. Users of the PC Emulator will especially benefit from the increased execution speed. 


The ARM3 Card is supplied with dise-based software to control the cache operation, both from the Desktop and via star 
commands. The comprehensive user guide not only covers the control of the ARM3 card at all levels, but also contains details of 
differences between the ARM2 and ARM3, and a section explaining the theory of cache systems. 


Nole: The Becbug ARM3 Card must be fitted by an Acorn approved component level service centre, as the existing ARM 2 chip has tobe removed. This includes Beebug and many 
major Acorn deniers. The Beebug ARMS i unsuitable for the A3000, as the ARM2. processor in this machine ts soidered directly to the circuil board, 


J Beebug Ltd., 117 Hatfield Road, St Albans, Herts, AL1 4JS. Please add VAT at 15%, This advert was 
i} i Tel. 0727 40303 Fax. 0727 860263 produced entirely with Ovation DTP 
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olds and upwards. Developed from the 
original BBC Folio, it operates at two 
levels: Simple Screen Folio provides an 
easy-to-use introduction to DTP for younger 
children, while Desktop Folio offers more 
versatile facilities which ESM claims will 
cater for all school DTP and word 
processing requirements. Desktop Folio 
costs £103.50 inc. VAT for a single copy, and 
site licences are available for multiple 
users. Further details can be obtained from 
ESM, Abbeygate House, East Road, 
Cambridge CB1 1DB, tel. (0945) 63441. 


FOREIGN LANGUAGE FONTS 


Outline fonts for Bengali and Punjabi 
characters are now available from the 
Hampshire Microtechnology Centre. The 
fonts were developed primarily for use 
within Hampshire schools, but have been 
made available in order to meet similar 
needs in other areas. Each font comes on a 
separate disc, together with sample Draw 
and Poster files and a keyboard overlay. 
The keyboard layout generally corresponds 
to that used by BBC Folio, as it was felt 
that many users will already be accustomed 
to this layout. Each font costs £20.00 for a 
site licence, and discounts are available for 
area licences. The Hampshire 
Microtechnology Centre is at Connaught 
Lane, Paulsgrove, Portsmouth PO6 4SJ, tel. 
(0705) 378266. For further details of the 
fonts, contact Martyn Wilson, Inspector for 
Technology (IT), on (0703) 715217. 


IMAGE CONVERSION 


X_Image, from Foster Findlay Associates, 
converts Archimedes sprite files into TIFF 
and other formats widely used on PC and 
other computer systems. With the Arc being 
increasingly used for the generation of high 
quality images, the facility to export these 
to other systems should prove very useful. 
X_Image is available at a nominal cost of 
£10.00 from Foster Findlay Associates, 148 
West Road, Newcastle upon Tyne, NE4 
9QB, tel. 091-273 1111. 


RISCBASIC EXTENSIONS 


Silicon Vision has produced a new Desktop 
Developers Environment (DDE) for its 
RiscBASIC compiler, which will allow Basic 
source programs created in Edit to be 
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compiled simply by dragging them onto the 
RiscBASIC icon, with syntax errors being 
highlighted in the Edit window. RiscBASIC 
itself is now being supplied as version 2.06; 
registered users may upgrade free of 
charge, or may upgrade to V2.06 with the 
DDE for £50.00 inc. VAT. Silicon Vision is at 
Signal House, Lyon Road, Harrow, 
Middlesex HA1 2AG, tel. 081-861 2173. 


MISSING LINK 


The Missing Link (TML) is a new high 
speed data link from D.R. Computer 
Products, which has been designed to 
transfer data between two Archimedes. The 
link consists of a card which plugs into the 
Econet socket (it does not use a podule slot). 
Any two machines fitted with link cards can 
be connected by a cable up to 10 metres 
long (3 kilometres with a fibre optic cable), 
and data transmission takes place at up to 
10 million bits per second. A Desktop File 
Transfer Utility is provided, and typical 
transfer speeds using this are 40K- 
120Kbytes/sec. The price of the card is 
£74.95 inc. VAT, and further details can be 
obtained from D.R. Computer Products, 
Unit 20-21 Enterprise House, 44-46 Terrace 
Road, Walton-on-Thames KT12 2SD, tel. 
(0932) 240432/566435. 


ALL IS REVEALED 


Revelation is a new product from Longman 
Logotron. Developed at Homerton College, 
Cambridge, it is an advanced art package 
designed specifically for children. Its range 
of colour manipulation facilities, including 
washing and blending, make it particularly 
useful for processing images taken from 
other sources, e.g. digitisers and scanners. 
All the other features you would expect 
from an art package are present, plus new 
facilities such as a set of measurement tools 
which allow the user to measure angles, 
distances and areas within a picture, thus 
making it useful for maths and science 
applications. Claimed to be very flexible, 
user-friendly and useful right across the 
curriculum, Revelation costs £87.40 inc. 
VAT (with a limited introductory offer of 
£62.10 until the end of March). Contact 
Longman Logotron for further details at 
Dales Brewery, Gwydir Street, Cambridge 
CBI 2LJ, tel. (0223) 323656. AY 


ra 


Desktop Zoom 


Magnify your Desktop with this short application from Mike lronmonger. 


he Magnifier application supplied on 

Applications disc 2 lets you look at an 
enlarged image of a small part of the 
Desktop. Desktop Zoom on the other hand 
will give a full screen enlargement of the 
Desktop at up to 1000 times magnification, 
where one pixel takes up more than the 
whole screen. It is mouse controlled, and 
you can zoom in and out, and pan across 
the whole area by moving the mouse in 
any direction. 


The effect is very dramatic, and may 
even have some use! It is very handy for 
seeing at a glance the way in which 
application sprites have been drawn. 
Moreover it may be useful in certain 
teaching situations where it is necessary 
to view a monitor from a distance. 


Zooming in and out Is easy 


SETTING UP THE APPLICATION 
To install Desktop Zoom on your 
machine you will need to create a 
directory called !Zoom, and save within it 
three files with the following names: 
1.!Run 
2. !RunImage 
3. !Sprites 


{Run 

The contents of this short file are given in 
listing 1. This file must be of type Obey. To 
create it, just use Edit, select Create New 
Obey file from the main menu, and type in 
the listing. 


!Sprites 

This is a standard sprite file. The easiest 
way to obtain an appropriate sprite is to 
“steal” the one used in the !Magnifier 
application on Acorn’s Applications disc 2. 
To do this, hold down the Shift key, and 
double-click on the !Magnifier application, 
so revealing the contents of its directory. 
Then load the !Sprites file from this 
directory into Paint, and rename the 
sprite !Zoom (using Paint's menu). Then 
save the sprite file (keeping the filename 
!Sprites) to the !Zoom directory. 


!RunImage 
This is the Basic program given in listing 2. 
First enter Basic by pressing F'12 from the 
Desktop, and then typing: 

Basic 
Type in listing 2 and save it to the !Zoom 
directory with the name !RunImage. 


USING THE PROGRAM 

Now get back into the Desktop, and 
double-click on !Zoom. This will install the 
application on the icon bar. Clicking Menu 
from here shows just one entry “Quit”. To 
make the zoom facility operate, click with 
Select over the icon on the icon bar, and 
the process will begin. Each further click 
on Adjust will increase the magnification, 
while each click on Select will reduce it. 
Moving the pointer around pans the view. 
To get back to normal, just click with 
Menu (regardless of where the pointer is 
positioned). 


Listing 1 
| !Run file for !Zoom 


WimpSlot -min 16K -max 16K 
Run <Obey$Dir>. !RunImage 


Listing 2 
10 REM >!RunImage 
20 REM Program Full screen zoomer 
30 REM Version A 1,00 


40 REM Author Mike Ironmonger 
50 REM RISC User March 1991 
60 REM Program Subject To Copyright 


80 ON ERROR PROCerror (ERR, REPORTS) :GO 
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90 PROCinit 

100 : 

110 REPEAT 

120 SYS"Wimp Poll", 6133,block% TO A% 

130 CASE A% OF 

140 WHEN 6: PROCmouse click (block$!8) 

150 WHEN 9: quit%=(!block#=0) 

160 WHEN 17,18: quitt=(block$!16=0) 

170 ENDCASE 

180 UNTIL quit’ 

190 SYS"Wimp CloseDown" 

200 END 

210 : 

220 DEFPROCmouse_click (B%) 

230 CASE Bt OF 

240 WHEN 2 : PROCcreate_menu(!block’) 

250 WHEN 1,4 : PROCzoom 

260 ENDCASE 

270 ENDPROC 

280 : 

290 DEFPROCcreate_menu (X%) 

300 $menu%="Zoom" 

310 menu$!12=670207 :menu$!16=100 

320 menu$!20=44:menu$!24=0 

330 menu%!28=680:menu% !32=0 

340 menu$!36=67000029 

350 $(menu%+40)="Quit® 

360 SYS"Wimp CreateMenu", ,menu%, X$-70, 
140 

370 ENDPROC 

380 : 

390 DEFPROCzoom 

400 SYS"OS ReadModeVariable",MODE,? TO 
+ reqs 

410 reqt+=100 

420 SYS*"XOS Module",6,,,rea% TO ,,spr% 
> 

430 IF FSANDI ERROR 1,"Can’t claim eno 
ugh memory for the zoom." 

440 !sprt=reqt:spr3!4=0 

450 spr$!8=16:spr%!12=16 

460 : 

470 scwb=1280:scht=1024 

480 IF MODE=16 OR MODE=17 OR MODE=24 s 
cw8=2112 

490 SYS"OS SpriteOp", £110, spr’, "screen 
"),scwh-1,sch$-1 

500 scalek!8=scwk:scale$!12=sch% 

$10: 

520 ox%=0:0y$=0:mag=2:omag=0 

530 PROCwait 

540 : 

550 REPEAT 

560 PROCmove 

570 IF NOT quit PROCplot 

580 UNTIL quits 

590 SYS"0S SpriteOp",&122,spr%, "screen" 
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600 SYS"0S Module", 7,,spr% 

610 SYS"XOS_ ChangeDynamicArea", 1,-req% 
620 quit ¥=FALSE 

630 PROCwait 

640 ENDPROC 

650 : 

660 DEFPROCmove 

670 REPEAT 

680 MOUSE x$,y%,bs 

690 CASE b% OF 

700 WHEN 1 : magt+=mag/20:IF mag>1000 
mag 1000 

710 WHEN 2 : quit$=TRUE 

720 WHEN 4 : mag-=maag/20:IF mag<l ma 


g=1 


730 ENDCASE 
740 UNTIL x%<>ox% OR y$<>oy% OR mag<>o 


mag OR quitt 


750 : 

7160 xt=scw%/2-x%*mag:wt=scw$ *mag 
770 IF x%>0 xb=0 

7180 IF xh+wh<scwh+] xt=scwht]-w% 
790 yhesch*/2-y%*mag:ht=sch$*mag 
800 IF yb>0 y%=0 

810 IF yh+ht<sch$+3 y$=scht+3-ht 
820 ENDPROC 

830 : 

840 DEFPROCplot 

B50 oxt=xt :oyt=y%$:omag=mag 

860 !scalet=w$:scale$!4=h% 

870 SYS"OS SpriteOp", 6134, spr%, "screen 


*,xt,yt,,scalet 


880 ENDPROC 

890 ; 

900 DEFPROCwait 

910 REPEAT 

920 MOUSE x$,y%,b% 

930 UNTIL bt=0 

940 ENDPROC 

950 ; 

960 DEFPROCerror (!block4, $(block$+4)) 
970 SYS"Wimp ReportError", block%, 1,"Zo 


990 ; 
1000 DEFPROCinit 
1010 SYS"Wimp_Initialise", 200, 643534154 


»"Zoom" 


1020 DIM block% 99,scale$ 15,menu% 99 
1030 quit %=fALSE 

1040 : 

1050 !blockt=-1:block#!4=0 

1060 block’ !8=0:block#! 12-68 

1070 block$!16=68:block%!20=s 300A 
1080 S$ (block$+24}="!Zoom" 

1090 SYS"Wimp_CreateIcon",,block’ 
1100 ENDPROC 


AU 
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ArcScan Ill 


A new multi-tasking version of Arcscan, the customisable magazine database 


New features for ArcScan II a Te) 


* now includes subject and function index to Acorn's 
ANSI-C manual (Release 3) 

* provides flexible keyboard search on any entry 

¢ improved search logic - choice of 3 logical operators: 
OR, AND and NOT 

¢ features dynamic memory management, returning 
unused memory to the Wimp 

* uses dedicated ARM code routines enabling rapid 
information retrieval 

* finds are displayed in a fast scrolling Wimp window 
allowing you to browse through all entries retrieved. 

* fully user customisable allowing other databases to be 
automatically incorporated in the control panel display 

* anew detailed manual and extensive on-screen help Searching is almost instantaneous 


pee ; ArcScan Il contains the Following Databases: 
tt: Cote FT) 
Search for: ®@ RISC User Volumes 1, 2 and 3 
Es ims ® BEEBUG Volumes 1-8 


ithe 


The Indexes to the following major Archimedes manuals: 
® Basic User Guide (Arthur) 

© Programmer's Reference Manual (Arthur) 

© RISC OS User Guide 

© RISC OS Basic Manual 

© RISC OS Programmer's Reference Manual 

* ANSI C Manual (Release 3) 


Tbe on-screen belp in action 
It is simple to perform a search: 


1. If you need to know about Obey Files, enter the words ‘obey’, ‘files' and click on the AND logic. All finds in RISC User 
will be instantly displayed. You can now call up the Acom Manuals indexes and repeat the search to get further 
references. 

2. To find the SWI name for SWI &400D4, select the new Programmer's Reference Manual from the menu, enter "SWI 
&400D4", and the answer appears, complete with page references, 
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ArcScan II Disc +Manual £14.95 members (£18.95 non-members) Stock Code PAS3 
ArcScan Ill Upgrade (from ArcScan ID £4.75 members (£7.95 non-members) Stock Code PAU3 i 
Please add 60p p&p. For upgrade, please send the old ArcScan II disc or label. 1! 

When ordering please quote your name and membership number. 1 


Man i cc cs rn a cas we me ee a a re ee ee ee ms es 


BEEBUG Ltd, 117 Hatfield Road, St Albans, Herts ALI 4JS. Telephone (0727) 40303 Fax (0727) 860263 
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Magpie 


Information Organiser from Longman Logotron 


Reviewed by Mark K. Sealey 
WHAT IS MAGPIE 


Magpie is an easy to use yet 
relatively sophisticated package which 
presents visual and textual material 
both on screen and optionally as hard 
copy. It is intended for use in schools - 
typically for project work - but has 
many other uses. 


For example, anyone needing to 
work interactively with information on 
screen or to compile presentations 
using graphics and text, as well as 
sound, could use Magpie as an 
alternative to Genesis II. 


() 2s = 
Figure 1. Potential information sources for a 


A copyable utility for “reading” 
material created with the package (but 
not for editing it) allows presentations to 
be freely distributed for use by others who 
do not own Magpie itself. 


Yet the product has potential as a basic 
desktop publisher too; this is chiefly 
because it makes use both of an intuitive 
interface and of the Acorn Outline Fonts. 
In general, its speed of operation, data 
compression techniques and overall feel 
mean that anyone interested in this type 
of software should look seriously at Magpie. 


THE PACKAGE ITSELF 

Magpie comes on two discs (program 
and examples) with the usual Logotron- 
style key-dise protection system. This will 
be a disincentive to many users, 
particularly those in small schools who 
cannot afford a site-licence and for whom 
safe storage of “the original disc” may not 
be guaranteed. There is also an excellent 
A4 size 75 page manual. 


It is advisable to follow the lengthy 
and thorough “getting started” section of 
the documentation. By the time you have 
done so, you will have made a separate 
data disc and copied those !Fonts supplied 
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Magple file 
by Longman Logotron onto it. Magpie only 
works with RISC OS: and Acorn’s useful 
Sysmerge utility for updating !System to 
the latest versions of the modules is 
included with the package. 


USING MAGPIE 


Once Magpie is installed on the icon 
bar (the application is fully multi-tasking) 
work can begin - either by dragging a 
Magpie file onto the main icon or clicking 
Menu over it to create a new folder. 


The physical model for Magpie is that 
of the ring-binder; it is composed of 
sections each with one or more pages. Both 
can be moved or new ones added, and a 
page can contain graphics (including 
sprites), arrows and lines for annotating 
the graphics, text, frames and rectangles 
(see fig.1). Additionally these pages can 
include sound samples and music 
(!Maestro files). What is more, they can be 
linked so that the user can follow a theme 
or work interactively through a 
presentation. More of this linking later. 


Modelling all of this on screen in a 
consistent and accessible way was always 
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going to be the most challenging task for 
Magpie’s designers and programmers. As 
well as providing a main text-bearing 
menu box for overall page operations, they 
have opted for a relatively standard, 
Impression-like, style of plinthed dialogue 
boxes. 


The purpose of some of the icons, to be 
truthful, is not as self-evident as it might 
be. A colour crib-card with the product 
(showing icon functions and all text 
equivalents, perhaps in menu-map 
context) might have been helpful. 
Nevertheless, the tutorial takes you easily 
through the process of creating a Magpie 
“binder” and dividing it into sections of 
your own choice. 


RIPE en eee Tk ee 
A binder contents page shows the sections and pages in a binder, 

when using !Magpie there is also a control panel containing icons. 

The control panel allows you to create/edit/delete sections and 

pages. All pages must be placed in a section, however, do not 

worry if you wish to change your wind at a later date: sections 

land pages can be freely moved about, 

ther icons in the control panel allow you to change the 

preferences settings for the binder, search for text, print pages, 

create a title page, hide subsections away. 
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Figure 2. Magpie binder contents page 


Imagine the theme was architecture, 
then the “sections” might be: building 
techniques, materials, famous architects 
etc. The pages might then contain 
annotated examples appropriate to the 
section: biographies with scanned 
portraits, text on stones or line-art of 
construction methods. A section can, and 
usually will, contain several pages. 


Although both pages and sections can 
be added as afterthoughts, some planning 
is advisable. You are free to place all 
scanned and sampled material as well as 
text and graphics files in a disc directory 
of your own choice. 


When you begin to lay all this out, you 
will be asked if you want an A4 or A5 size 
folder, although the default (and preferred) 
size is that of the screen itself; at this 
stage you can also change parameters 
relating to colour. When it comes to 
graphics (from Draw, say), the aspect ratio 
can be preserved during rescaling. This is 
only one of many touches that add to the 
appeal of the product. 


MENUS AND ICONS 

Although you are led through the set- 
up stage with whichever of Magpie’s 
menus are necessary, most of them are in 
fact context-sensitive or can be popped up 
when required (mouse Menu button). 
Indeed, you quickly become used to finding 
your way about the package. Chief among 
the menus is the main page toolbox. This 
has eight icons to edit a page, and permits 
sizing and placing of objects, text-entry 
and editing, styles and formats of display, 
linking and browsing etc. 


Again, the purpose of all these icons is 
not as memorable as it might be. There 
are few to learn, however, and the 
reference section of the manual is a model 
of clarity, so this should not be seen as a 
major drawback. The relevant icon 
appears in the wide left-hand margin in 
case you should forget. 


LINKING PAGES 

It may well be at this point that you 
wish to enable later users to “turn” pages 
within the binder - by means of “buttons”. 
This is easier to do than to explain but 
basically allows you to consult pages in 
various sequences, extract objects from 
the presentation for use in your own 
applications and hide/reveal or “play” 
them as appropriate. 


For instance, the designer of the 
presentation may want to simplify it by 
introducing the illustrations only after 
chunks of text have been read or by 
directing the reader to a section of the 
binder where all the illustrations are 
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grouped. Later in the presentation it may 
be necessary to visit the illustrations 
again, this time in a historical sequence 
arranged according to time. But now the 
routing could well be entirely different. 


isp ie, Fags a 


the toolbox (for entering text, drawing lines, arrows and 
rectangles, creating buttons), or by dragging files from filer 
directory displays or directly fron other applications, 


Once placed on a page itens can be manipulated using the other 
tools available; moving and resizing, reordering or deleting, 
The paper colour of a page can be changed using a menu option, 


ea 


ge 


__ Text files, nay be 
JSF] isvorted to text franes 
= (see the pen tool). 


Sprite files. 


braw Files, Hote that all text 
objects are displayed correctly 


Sound samples, fron !Araadeus 
ir Armadillo @ bit samplers, 
isplayed using a ‘speaker’, 


finy other file (but aot 
directories, as used by 
Impression and Genesis) nay be 


placed on a page, In this case 
the File type icon for the file 
will be displayed. 


fusic Files fron !Maestro, 
displayed using 2 ‘speaker’. 


C1 anveurrnansasar 


Figure 3. File types directly usable by Magple 


Such pages will contain either a 
graphic or text prompt inviting the user to 
click with the mouse and/or use specified 
keypresses to follow this routing, which 
needs to be quite sophisticated; in some 
respects it may turn out to be not very far 
removed from teletext page routing 
techniques. 


Once again, use of the dialogue boxes 
necessary to achieve all of this is logical 
and straightforward. For example, the 
plain “button icon” is selected and a 
button to “turn the page” is placed exactly 
where you want it on the screen, typically 
at the bottom right. This placing is 
achieved by exactly the same mechanism 
used to position and scale any other 
Magpie object. 


The button’s characteristics can be 
altered at will: it can be transparent, one 
of several predefined graphics (an open 
book for pages backwards and forwards or 
a selection of arrows) and may or may not 
set a “tag” for the user to skip straight 
back to this same starting point in the 
binder when the page pointed to by the 
button has been read. 
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Quite intricate and lengthy interactive 
learning sequences, too, can be built up 
very easily by using this feature of 
Magpie. Of course, all the data relating 
not only to the material itself but how it 
behaves in this latter respect is saved in 
one file somewhat like a much scaled- 
down and static interactive video disc. 


SOME PROS AND CONS 


A data compression technique is 
employed so that a full page with perhaps 
two graphics and three or four boxes of 
text, annotation and links occupies no more 
than 12K, which could actually well be less 
than an original sprite contained in it. 


The downside is that a screen may 
take several seconds to appear in full, and 
there is no overall indication whereabouts 
in the binder you are at any one time, 
except by referring to the window title bar. 
There are other very minor snags in 
editing with Magpie. A text’s font cannot 
be changed once the text has been entered 
and displayed; to make up for this, the 
selection of font, leading and sizes is 
amongst the easiest for packages of this 
kind now available for Acorn machines. 


Pages can be printed, singly and in 
sequence, using the RISC OS drivers. Text 
can be searched, imported from other 
applications such as Edit, and all manner 
of alterations to material made very 
easily. 


There are intelligent control key 
equivalents to some of the operations, and 
the relatively shallow menu structure as 
well as total Desktop compatibility make 
Magpie very easy to use. 


MAGPIE READER 

Once you are happy with your pages 
and their contents, you (or someone else) 
will want to use them. This is where 
MagpiRead, the browser supplied with the 
package, comes in. You will discover from 
the manual that you can distribute this 
module with your pages (which are thus 
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not entirely stand-alone) provided you 
make no charge. 


Here, although it uses similar 
conventions to those of the main program, 
passage through and selection of features 
on the pages is direct and self-evident. 
Again, the videodisc analogy springs to 
mind, though things are much simpler, 
easy to use and effective. 


CONCLUSIONS 

Longman Logotron has come up with a 
winner. Unlike some of the more complex 
DTP packages, Magpie has been limited to 


Longman Logotron has also designed a 
menu/control structure that, while 
perhaps relying too heavily on icons, 
makes good sense and speeds up, rather 
than hinders, what you are trying to do. 


Advanced presentations would be 
better done with Genesis I]. But where 
clear easy to achieve results are needed 
quickly, and full control of the on-screen 
effects is at a premium (for first time 
users and children, maybe), Magpie - at a 
reasonable stand-alone price and with its 
excellent manual - can be thoroughly 
recommended. 


a simple specification with just those 


features anyone wanting to edit pages Product Magpie 

simply would want. There is just the right Supplier scan eae Logotron ae 
‘ > ales brewery, Gwydir otreal, 

number of ‘drop shadow and frame type Cambridge CBI 2LJ 

options; colours are limited to 16 and Tel. (0223) 323656 

there is no plethora of arrow styles, for Prica £54.00 (stand alone) 


£175.00 Primary site licence 


example, with which to label diagrams; e208 ap Seccudely oie Noehes 


most pleasing results can be achieved 
using those provided. 


~~ IVoiceBuilder 


from MJD SOFTWARE, the makers of /A\ 


!VoiceBuilder is a new package from MJD Software, offering the WG a 
powerful, but easy to use facility for creating new sound VOICE modules. 


Within minutes, new instruments and effects can be created for use with all commercial 
music packages, or within your own programs. 


All prices exclude VAT and p&p AY 


Main features include: 

v< Selection from wide range of waveforms and envelopes 

¥< Full control over the time domain for attack / looping / release phases 
Y< Separate loop positions for amplitude and pitch envelopes available 
v< Sounds instantly available for testing via keyboard or MIDI 

v« Full RISC-OS multitasking - use alongside Maestro, Rhapsody etc. 
v* Ultra-compact module storage - 8 voice module takes up roughly 13k! 


AVAILABLE NOW FOR ONLY £19.95.£1.50 Pap 
MJD SOFTWARE 13 BURNHAM WAY LONDON W113 9YE 


Beebug Public Domain Software - New Releases! 


Mania orsesy? Bags Nerntcfi Salas asl mnebaa agape bia npr ait age oeeagh Further titles will be added in the future. 
also offering a Sampler disc with a selection of public domain programs from all areas of interest. 
Unlike other Public Bontaia toftwase, our discs contain as near as possible to 800k (and not less than 700k). 
Each disc includes a 'Read Me’ file, and there are some instructions with the programs. 

Itis our policy with our public domain library that the Public Domain discs are available only to RISC User members 
for £2.99 (postage is 60p for the first disc and 30p for each additional disc). The discs are offered as seen, and we cannot 
enter into any discussion regarding their contents, 

To order phone (0727) 40303 , Fax (0727) 860263, or write to (quoting your membership number): 

BEEBUG, 117 Hatfield Rd, St. Albans, Herts AL1 4JS, 


DEMOS 
PD12Disc 


Contains 5 sound and graphics demos from Hugo Fiennes 
of the Serial Port. All five are stunning examples of what 


the Arc is capable of. 
PD21 Disc * 


Contains three demos, Balls, Balls2 and BIA-Tetris. The 


latter is a game as well as a demo. 
PD22 Dise 


Contains three demos, Noah, Chips and Demo01. 


PD23 Disc ® 


Contains four demos, Bounce, Crimbo, ColDemo and 


Rotate. 
PD24 D 


Contains ives demos, Demo, Gopher and Overscan, 


PD25 D 


Contains eu demos, Deskballs, DudsDemo, EgIntro, and 


Z-Brother. 
PD 26 Disc * 


Contains three demos, Sister, Wibble and SkullDemo. 


PD27 Disc * 


Contains two demos, GrannyChow and Windows. 


GRAPHICS 
PD13 Disc 


Contains the Projector application that displays 


films created with the Ace Computing Mogul 
package. Six example films are included. 


PD18 Disc * 
Contains a program that displays several still 
and animated ray traced pictures. 


EDUCATION 

PD 14 Disc 

Contains REG, a suite of programs for 
recording student achievement levels in 
schools. Also, included is a way of recording 


attainment with Colton Software's Pipedream. 


ART 

PD15 Dise 

Contains Arctist+ and BigM, both 256 colour 
art packages, along with Design, a 
symmetrical pattern nee 


MUSIC 

PD16 Disc * 

Contains 230 tunes for loading into the music 
package Maestro, with enough variety to suit 
most tastes, 


TRICKS AND NOVELTIES 

PD17 Dise 

Contains a collection of 27 amusing trick and 
novelty — Some of them produce the 
weirdest 


GAMES 
Co tains 10 Adevnture, Battle, 

nta games programs, t 
Battleships, Connect4,Darts, Fish (Pelmanism), Fruit 
Machine, Golf, Hangman and Impact. 


PD20 Disc 

Contains 12 games programs, Invaders, Line Of Five, 
Othello, Pelmanism,Rocks, Rubik Cube, Simon, Solitaire, 
Star Trek, Tetris, Tile Trial and Yahtzee. 


UTILITIES 

PD 28 Disc 

Contains 20 utilities of various types. These are all 

extremely good and there is something here no doubt to 

ergs everyone. Space does not permit full — ions 
ut the file list is, 1stFile, ASm2, C! Seog hia 

Display, Drawlink, Dustbin, Filety pot encodes fleUti Find, 

Keys, Loadprogs, MultiPrint, New 

PD_Impress, PrinterTx, ProgCalc, and Set ieee 


CLIPART AND PICTURES 

PD29 Dise 

Contains over 4 megabytes of Sprite pictures which can be 

used as clip art to load into DTP or use in your programs. 

The files are naturally in a compressed form and the disc 
contains the file to uncompress them and has instructions. 


PD30 Disc 

Contains over 2 megabytes of Sprite clip art and Draw files 
to load into DTP or use in your programs, The files are 
naturally in a compressed form and the disc contains the 
file to uncompress them and has instructions, 


Public Domain deingleé3 Disc (PDS1) 
This disc contains sample programs from the Beebug Public Domain Software 
ee ee ‘ 
pe dhercinad raisehebrevaphnrt cv ayponty 
minutes. The quay of gute uring pacity payed og 
computer's monitor speaker, or a hi-fi 
Accounts - 27 A pe a ae ee 
with the program but all functions are selected from the main menu which is self 


explanatory. An example file is included. 
~ This is a versatile disc program producing professional looking 


DiscLabel labelling 
labels for 3.5" discs. A Help file is included with the program. 


Follow - Gorell pal viuar maga ancl aly of beady eyes on the 
desktop that follow the mouse pointer wherever it goes. bere! 


Hangman - A well presented and implemented version of the old word game of 
Hangman with an animated finale. 


Multiprint- A utility to allow the printing of files by creating a task list of the files to 
Bre tele beng cabs tas tence Bike cb cone WA sb pects 


Rotate - A animated demo in which you can alter the effects by pressing 
dow bee catio uate 


STD - A useful utility to search for telephone STD codes or find a town from its STD 
code. A ReadMe file is included in the program. 


Wanda - A novelty demo program that infests your desktop screen with a shoal of 
bubble-blowing goldfish! 


Hard Disc Archiver 
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by J.V. Parker 


he program presented here enables 

you to back up a hard disc onto a 
number of floppies, and has been designed 
for both ease of use and program 
simplicity. As a result, it can be typed in 
with very little effort. The program is not 
multi-tasking, since when writing to or 
reading from disc the CPU has very little 
spare time (try running Usage on 
Applications disc 2 while backing up a disc 
to see what I mean). It doesn’t need to be 
an application because it has no sprites or 
resources and runs from the root directory 
of the hard disc. After setting up the 
program initially for your system, it will 
archive the complete hard disc the first 
time it is run, and thereafter will just 
update the files which have a different 
date stamp from those in the archive (i.e. 
the latest versions). 


One useful feature of the program is 
that archived files are not stored in a 
compressed form, so they can be run from 
the backup discs or just dragged into a 
filer window. 


SETTING UP THE PROGRAM 
PROCinitial sets up the variable 
strings which are used to control the 
copying process. These strings define the 
source and destination paths, and the 
copy options which will be used. The 
source path in line 180 should be tailored 
to suit your drive, e.g. if you have a SCSI 
drive it might read: 
180 hardS="SCSI: :SCSIDisc4.$." 
The copy options defined in option$ are as 
follows: 


A(ecess) on. 

~C(onfirm) off, otherwise you'll wear 
your mouse out. 

~D(elete) off or you'll wipe your hard 
disc. 
F(orce) on to ensure that older copies 
on the floppy are overwritten. 


L(ook) on. 
N(ewer) on to ensure only newer files 
are updated. > 
~P(rompt) off - not needed when 
copying from hard to floppy. 
Q(uick) on so that application 
workspace is used to speed up the 
process. 
R(ecurse) on to copy sub-directories. 
~S(tamp) off. 
(s)~T(ructure) off since you want the 
files as well as the directory structure. 
~V(erbose) off (unless you have all 
night to check the names). 


These are all documented in the Risc 
OS User Guide pages, 202-204 or 208-210 
depending on your version of the Guide. 


If you have a program which writes 
files without date stamps (e.g. a BBC 
program running under !65Host), then 
you will need to change option$ to ignore 
date stamps, i.e. change N to ~N. Also, 
files which are written to (e.g. using 
OPENUP) do not have their date stamps 
updated automatically so if you have a 
directory where this happens on a regular 
basis, you'll have to change the Newer 
option for that as well. In the example set- 
up shown in the listing, this is done in the 
case of floppy disc 7 (lines 440-470), where 
option$ is changed before and after 
archiving !Viewsheet. 


USING THE ARCHIVER 

The first step is to format and name 
enough discs. The names are BU1 to 
BUn. To calculate how many discs will be 
required (i.e. the value of n), you must 
first decide what is to go onto each disc. 
Use the Count option provided by the 
Filer to find the total size of all the files 
in a directory, then add 2K for the 
directory itself and the same for any sub- 
directories. If you aim to put a maximum 
of, say, 500K on each floppy, this will 
allow plenty of room for either new 
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programs or revised versions under a new 
name when you come to update your 
archive. 


Having done this, you can then write 
PROCupdate to suit your system. Each 
WHEN clause refers to the floppy of the 
same number, e.g. in the statement 
following WHEN 1, the parameter passed 
to PROCosc defines the directories to be 
put onto disc BUI (in this case a single 
directory called !Fonts). You can place 
more than one directory on any floppy by 
simply making additional calls to 
PROCosc, as in the example for floppy 2. 
However, if a disc is to contain only part of 
a directory (as for disc 5 where only part 
of directory C is copied), then you must 
create directory C on BUS first, otherwise 
you will get a “not found” error. 


Bear in mind that if you undertake a 
major restructuring of the organisation of 
your hard disc, you will need to edit 
PROCupdate, but you will not need to re- 
archive anything for which you still have 
the original backup discs. 


The program will not wipe files from 
the floppies which are no longer present 
on the hard disc, so eventually you may 
have to wipe them manually from time to 
time to avoid running out of space. As long 
as a floppy still has the same name, it will 
still work even if you have wiped it clean, 
though the next time it is used all files 
will be copied. This does have one 
advantage: if you wipe something from 
your hard dise and decide later that you 
want the file after all, it may still exist on 
the backup disc. 


10 REM >Archiver 

20 REM Program Hard Disc Backup 
30 REM Version A 1.00 

40 REM Author J.V.Parker 


50 REM RISC User March 1991 

60 REM Program Subject to copyright 
BOs 

80 ON ERROR PROCerror:END 
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90 PROCinitial 

100 FOR I%=1 TO 30 

110 PROCupdate 

120 NEXT 

130 END 

140 ;: 

150 DEF PROCinitial 

160 oscli$="" 

170 copy$="Copy" 

180 hard$=" adfs::4.$." 

190 floppy$=" adfs::BU" 

200 disc$=".$." 

210 optionS="A~C ~DF LN ~PQR-<S 
~T ~y" 

220 from$="" 

230 ENDPROC 

240: 

250 DEF PROCosc(from$) 

260 oscli$=copy$t+hard$+from$+floppy$t+s 
TRSI$+disc$+from$+option$ 

270 OSCLI oscli$ 

280 ENDPROC 

290 : 

300 DEF PROCupdate 

310 CASE I% OF 

320 WHEN 1 : PROCosc("!Fonts") 

330 WHEN 2 : PROCosc("!System") 

340 PROCosc("! Teletext") 

350 PROCosc ("Archive") 

360 PROCosc("!Utils. !Boot") 

370 PROCosc("! Utils. !Run") 


380 WHEN 3 : PROCosc("Basic") 

390 PROCosc ("!Birds") 

400 WHEN 4 : PROCosc("Stars") 

410 WHEN 5 : PROCosc("C.!Cstart") 

420 PROCosc ("C.makefiles") 

430 PROCosc ("C. programs") 

440 WHEN 7: 

450 option$=" A ~C ~D F L ~N ~P Q 
R ~S «T ~v" 

460 PROCosc ("!Viewsheet") 

470 option$="A ~C ~D F LN ~P Q 
R ~S ~T ~vV" 

480 ENDCASE 

490 ENDPROC 

500 : 


510 DEF PROCerror 
520 PRINT REPORTS" at line ";ERL'oscli$ 
530 ENDPROC AU 
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IMAGINE 
what your Archimedes 
would be like if we 
didn't produce over 200 
PostScript™ compatible 
high quality fonts. 


For font catalogues, price lists, technical Info etc, contact 
The Electronic Font Foundry 
18, Brockenhurst Road, Ascot, Berks. SL5 IDL 
Telephone (24hrs) or Fax: 0344 872923 


Watchdog Update 


Nick Smith adds some enhancements to our popular Watchdog Anti-Virus 


application. 


atchdog was originally published in 

RISC User Volume 3 Issue 7. Its 
purpose was to protect discs from being 
infected by viruses, by filtering out certain 
operating system calls which involve 
writing to disc. It has proved to be a 
popular application, particularly with the 
spread of public domain discs for the 
Archimedes, and we have now updated 
the original to include additional levels of 
protection. A minor bug has also been 
fixed. 


As originally published, Watchdog 
allowed normal saving and deleting, as 
these operations are often in continual use 
while working with the computer, but 
prevented FileCore_DiscOp calls and also 
the OS_FSControl call used by *Wipe. In 
addition, a facility was provided to “clean” 
a disc, by compacting it as far as possible 
and then wiping the free space to remove 
any hidden viruses. The magazine disc 
version also offered an extra level of 
protection by preventing all write 
operations. 


This extra protection provides the 
main feature of the new version listed 
here (V2.50). It is now possible to specify 
either partial or total protection; choosing 
the latter will prevent viruses from 
performing any operations which will 
write to your disc. A fourth option has also 
been added, which not only prevents 
writing to, but also reading from a disc. 
Thus all disc access is effectively 
prohibited. This can be useful for keeping 
prying eyes away from your files, so if, for 
example, you have’ confidential 
information on the disc, you can switch 
this option on if you need to leave your 
computer unattended, and be sure that 
no-one else can read the files in your 
absence. 
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AMENDMENTS 

The two listings given below show the 
necessary modifications to be made to the 
original listings. Some of the lines are 
replacements for existing lines, while 
others are new lines to be added. Load the 
original /RunImage program into Basic 
and then type in the lines given in listing 
1. Then save the whole program back as 
/RunImage. Follow the same procedure 
with MakeWatch. It is essential that the 
line numbers of the original programs are 
exactly as listed in Volume 3 Issue 7, and 
must not have been re-numbered, 


Before you can use the new Watchdog, 
you must run MakeWatch to create a new 
WatchRM module. You will also need two 
additional sprites in the /Sprites file: 
!watchdog3 and !watchdog4. These should 
be the same as the existing sprites but 
with a different colour light for each level 
of protection, e.g. black for off, yellow for 
partial, orange for total and red for 
read/write. 


USING WATCHDOG 

The application is used in exactly the 
same way as before. When installed on the 
icon bar, the icon will reflect the current 
protection level both by the colour of the 
light and the text below. Pressing Menu 
over the icon will now display the 
following options: None, Partial, Total, 
Read/Write, Clean and Quit. The Clean 
option works as before, except that a small 
bug has been fixed so that discs with no 
bytes of free space can be cleaned without 
crashing. The other options are self- 
explanatory and refer to the protection 
levels described above: None allows all 
disc access, Partial prevents write 
operations apart from saving and deleting, 
Total prevents all write operations, and 
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Read/write prohibits both reading from 
and writing to the disc. 


This month’s magazine disc contains an 
even more advanced version of Watchdog 
(V3.00), which in addition to the 
enhancements presented here, offers a 
number of extra features. For example, 
with protection set, it is possible to specify 
a pathname which remains unprotected; 
thus you can write to a floppy while still 


protecting your hard disc. 
Listing 1 
10 REM > !RunImage 
20 REM Program Anti-Virus utility 
30 REM Version A 2.50 
40 REM Author Nick Smith 


50 REM RISC User March 1991 
60 REM Program Subject to Copyright 

70: 

100 DIM blk$ 512:DIM menu$ 228 

1200 CASE !blk% OF 

1205 WHEN 0,1,2,3:PROCProtection(!blk$) 
1210 WHEN 4;PROCClean 

1215 WHEN 5;finishedt=1 

1220 ENDCASE 
1260 DEF PROCProtection(item$) 

1270 protect t=items 

1280 IF itemt=0 THEN 

1320 ENDIF 
1330 IF item$=1 THEN 
1340 OSCLI "Lock P" 
1341 $(buffer$+30) ="S!WatchDog3" 
1342 $(buffer$+20)="Watch XOn" 

1343 ENDIF 

1344 IF itemt=2 THEN 

1345 OSCLI "Lock T" 

1371 IF itemt=3 THEN 

1372 OSCLI "Lock R” 

1373 $(buffert+30)="S!WatchDog4" 

1374 $(buffer$+20)="Watch R/wW" 

1375 ENDIF 

1600 IF protect%=0 item$!0=1 ELSE item 
10=0 

1621 $(item$+12)="None"+CHRS$ (0) 

1622 itemb=itemt+24 

1623 IF protect%=1 item$!0=1 ELSE items 
'0=0 

1624 item$!4=0 

1625 item$!8=47009011 


1626 $(item$+12)="Partial"+CHR$ (0) 

1627 itemb=items+24 

1628 IF protect%=2 item$!0=1 ELSE item? 
!0=0 

1629 item}! 4=0 

1630 item$!8=67009011 

1631 $(itemt+12)="Total"+CHRS (0) 

1632 itemt=item$+24 

1633 IF protect$=3 item$!0=1 ELSE item$ 
'0=0 

1634 item$!4=0 

1635 items! 8=&7009011 

1636 $(itemb+12)="Read/write"+CHR$ (0) 
1720 SYS "Wimp CreateMenu",0,menu%, (blk 
$!0)-200/2, 44*8+32 

1820 $(buffert+20)="Watch XOn" 

1830 $(buffer$+30)="S!WatchDog3" 

2010 OSCLI "Lock p” 

2020 protectt=1 


Listing 2 
10 REM >MakeWatch 
20 REM Program Module source code 
30 REM Author Nick Smith 
40 REM Version A 2.50 


50 REM RISC User March 1991 
60 REM Program Subject to Copyright 

240 EQUS "WatchDog"+CHRS$(9)+"2.50 ("4M 
ID$(TIMES,5,11)+") By Nick Smith"+CHRSO: 
ALIGN 

270 FNcommand ("Lock", Lock, 6010001, Lock 
Syn, LockHlp) 

330 .LockSyn EQUS "Syntax: *Lock [p/t| 
rw)":EQUB 0:ALIGN 

410 LDRB Rl, [RO] ;ORR R1,R1, #32 

411 LORB RO,drives:TEQ R1,#ASC"p" 

412 MOVEQ RO, #1:TEQ R1,#ASC"t" 

413 MOVEQ RO, #2:TEQ R1,#ASC"r" 

414 MOVEQ RO, #3:STRB RO,drives 

680 BIC RO,RO, #&FF:BIC R5,RO, #6300 

730 SWI "XOS_GBPB":BVS exit_clean:SWI 
"OS_ReadEscapeState" 

1061 TEQNE R11, #408: TEQNE R11, #409 

1062 TEQNE R11, #&0C:TEQNE R11, #40D 

1110 LDRB R12,drives:TEQ R12, #1:BEQ lev 
ell 

1120 TEQ R12, #2:BEQ level2:TEQ R12, #3 

1130 BEQ level3:B routine 

1140 : 

1150 .levell 
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1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
3 
1380 
7 
1390 
10 
1400 
1410 


TEQ R11,R10:BNE levell jump 

AND R11,R1,#%$1111:TEQ R11, #2 

TEQNE R11,#4:BNE routine:BEQ error 
-levell_jump 

TEQ R11, #&29:BNE routine 

TEQ RO, #27:BNE routine:BEQ error 


-level2 

TEQ R11,R10:BNE level2_jumpl 

AND R11,R1,#$1111:TEQ R11, #2 

TEQNE R11, #4:BNE routine:BEQ error 
-level2_jump1 

TEQ R11, #&29:BNE level2 jump2 

TEQ RO,#27:TEQNE RO, #24 

TEQNE RO, #25: TEQNE RO, #26 

BEQ error:BNE routine 
-level2_jump2 

TEQ R11, #&0D:BNE level2_jump3 

TST RO, #&480:BEQ error:BNE routine 
-level2_jump3 

TEQ R11, #&08:BNE routine:TEQ RO, #0 
TEQNE RO, #1;TEQNE RO,#2:TEQNE RO, # 


TEQNE RO, #4:TEQNE RO, #6:TEQNE RO,# 
TEQNE RO, #8:TEQNE RO, #9:TEQNE RO, # 


TEQNE RO, #11:TEQNE RO, #18 
BEQ error:BNE routine 


1420 : 


1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
#10 
1510 
1520 
1530 
error 
1540 
1550 
error 
1560 
1570 
error 
1580 


-level3 

TEQ R11,R10:BNE level3 jumpl 

AND R11,R1,#$1111:TEQ R11, #2 

TEQNE R11, #4:BNE routine:BEQ error 
-level3_jump1 

TEQ R11, #629:BNE level3 jump2 

TEQ RO,#27:TEQNE RO, #24 

TEQNE RO, #25: TEQNE RO, #26:TEQNE RO 


TEQNE RO, #32:BEQ error:BNE routine 
-level3_jump2 
TEQ R11,#&0D:BNE level3 jump3:BEQ 


-level3jump3 
TEQ R11, #408:BNE level3 jump4 :BEQ 


-level3_jump4 
TEQ R11,#&09:BNE level3 jump5:BEQ 


-level3_jump5 
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1590 TEQ R11, #&0C:BNE routine:BEQ error 
1600 : 

1610 .error 

1620 BIC R12,R14, #&FC000003 

1630 LDR R11, [R12,#-4]: TST R11,#(1<<17) 
1640 BEQ generate error:LDMFD R13!, {R10 
-R12} 

1650 ADR RO,errBlock:ORRS R15,R14, #(1<< 
28) 

1660 : 

1670 .generate error 

1680 ADR RO,errBlock:MOV R1, #6 

1690 SWI "OS ServiceCall":ADR RO,errBlo 
ck 

1700 MOV R9,#1:SWI "OS CallAVector" 
1710 LDMFD R13!,{R10-R12}:MOVS PC,R14 
1720 .const EQUD &FFF20000 

1730 .filecore EQUD 640540 

1740 .errBlock EQUD &108C9 

1750 EQUS "Protected disc":EQUB 0:ALIGN 
1760 : 

1770 J 

1780 NEXT passt 

1790 name$="WatchRM" 

1800 SYS "OS File",10,name$, &FFA, ,code% 
, 0% 

1810 PRINT'"Module Saved as '"name$"'," 
' 

1820 END 

1830 : 

1840 DEF FNcommand(com$,call, flags, synt 
ax, help) 

1850 [OPT pass% 

1860 EQUS com$:EQUB 0:ALIGN 

1870 EQUD call:EQUD flags 

1880 EQUD syntax:EQUD help 


1890 ]:=0 RY 


Skyfall Public Domain 
The Worlds Largest Archimedes Public Domain 
Skyfall has virtually every bit of PD ever written or 
drawn for the Archimedes, well in excess of 200 discs. 
Stracker, Galleries, Colour Digitizations, Applications, 
Games, Ray Traced, DTP Clips and Sprites, Mega 


Samples and the list goes on. All available at between 
£2.50 and £1.50 depending on quantity ordered. 


Send a £1 coin for our demo disc, 
or send an A5 SAE for the printed catalogue. 


Skyfall PD, 93 Jayshaw Avenue, 
Birmingham, B43 5RX. 
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Alan Wrigley reviews a new programmable database for the Arc. 


ase5 DBMS was first shown to the 

public at the BBC Acorn User Show 
last September. There are already, of course, 
a number of databases on the market for the 
Archimedes, some of them multi-tasking, 
and so the first question to ask is: “What 
makes Based different from the rest?” 


The answer is that Based has been 
designed from the outset as a programmable 
database, to be used by software developers 
as a basis for their own database 
applications, rather than a front-end 
database manager with a programming 
language tacked on. A multi-tasking Wimp 
front end has been supplied with the 
database, but the real scope of this package 
lies in the powerful set of Basic procedures 
and functions which will allow any 
competent programmer to design a database 
to his or her own specification. 


THE PACKAGE 


Base5 DBMS comes on a single disc, 
together with a ring-bound manual. The 
package I used for review also had a 
supplementary manual covering the multi- 
tasking front end and procedures which 
were not present in the original version, 
though these may be combined into one 
manual in the future. On the disc are a 
multi-tasking database application, 
WimpBase5, together with some sample 
database files including one of English 
monarchs which is used to provide examples 
throughout the tutorial section of the 
manual. Also on the disc are the libraries of 
procedures and functions which form the 
heart of the package. The main library 
contains some 80 procedures and 57 
functions which provide all the file and data 
handling facilities, while separate libraries 
contain procedures for mathematical 
functions, reports, and “relate” files, which 
allow a relational database structure to be 
created. Finally, the disc contains a line 
input module to handle keyboard input. 


Extensions to the system are planned, in 
the form of add-on libraries and utilities. 
For example, the latest developments, which 
should be available by the time you read 
this, are an advanced maths library, and a 


library to process data representing co- 
ordinate pairs, complete with an application 
which writes mouse co-ordinates directly 
into database fields. Also available to 
registered users is a technical journal called 
ForumS, intended to be a focal point for 
advice, comment etc. 


LIBRARIES 


The libraries form the core of the Base5 
system, and cover more or less every 
conceivable action you might want to 
perform. Each procedure and function is 
fully documented in the manual, with 
details of parameters required, actions 
taken and values returned when called. 
There are facilities to create, open and close 
databases, to add or delete fields and 
records, to browse, search and sort, and so 
on. Many functions can be made conditional, 
either on comparison tests, as in the case of 
searching, or on certain flags which can be 
set or reset; for example, the wse deleted flag 
determines whether deleted records are 
included in a search, while the exact flag 
determines whether string comparisons 
should be case sensitive. 


One particularly attractive feature of 
Based is that fields can be added, deleted or 
modified (e.g. by changing their length) even 
if they contain data. Most of us have had 
experience of setting up a database and 
spending many hours entering data, only to 
find that the field structure we defined at 
the start doesn’t cater for all eventualities. 
With many databases, the only solution is to 
start all over again from scratch, but with 
Based this need never happen. You do of 
course have to be careful when modifying an 
existing database structure, but on balance 
the flexibility this gives is more important. 


STRUCTURES 

When setting up a database, the 
maximum number of channels, fields per 
channel and records per channel must be 
specified. Obviously there will be a trade-off 
between the sizes specified and the memory 
available in the machine. The manual gives 
some guidance on how to calculate the 
memory requirements for a_ given 
configuration. The ability to have more than 
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one channel open at a time is useful when 
you want to design a relational database, 
where fields in one file can be linked to 


manipulate databases using the calls 
documented in the manual, adding your own 
code to perform the functions of the program 


fields in another. 


Fields are of fixed length format, and 
can be character, numeric or date in type. F 
Date fields have their own internal format, 
and there are procedures for accessing day, 
month and year and converting to Julian 
or Gregorian dates, as well as other 


which do not directly involve handling files 
or data. 


LSC 5 ITD ae TT) 
a ke 


Pile nane 
Function 
Record 15 of 113 


PASTROWAVTL ¢ Tereshicova 


5 STROWAUT? € 
functions relating to dates. ical ¢ 
ASTRONAUTS € y 
STROMAUTS € Tereshkova 
DATA TRANSFER pean First wonan in space 


Married Andrian Rikolyey 1964 


A database often stands or falls on its satire 


ability to import and export data in a 
form which can be used by other 
software. Base5 can export data in four 
different formats: Comma Separated 


ASTROWAUT? ¢ 
PUMESSTON —¢ Vostok 6 
SERIES c voSsTOK 
LAIMCHDATE D 16 06 1963 
DURATION ¢ 2d 22h 50m 
COUNTRY  ¢ USSR 
COMMENT ¢ First woman in space 


Values (CSV), System Data Format 
(SDF), plain text and, usefully, 
PipeDream format. It can also import all 
of these except PipeDream. CSV is a 
common format used by many packages 
in the PC world and elsewhere. SDF is a 
fixed length record format which can be 
recognised by other software and by some 
languages. 


INPUT 

A module and a supplementary library 
are provided to handle line input from the 
keyboard. This provides the building blocks 
for comprehensive input routines, enabling 
you to control which characters are allowed, 
force upper case etc. Of course, if you are 
writing a Wimp-based application and using 
writeable icons, much of this is already done 
for you by the Wimp, but there may be 
situations where you need more control over 
input than the Wimp offers. 


PROGRAMMING A DATABASE 

Using Base5 to create a database is not 
for beginners or dabblers. You need a good 
knowledge of Basic, and the ability to 
construct complex programs. It will also pay 
to be thoroughly familiar with the manual 
before starting work on a project, since you 
really need to be aware of what Base 5 can 
and cannot do before you even start to write 
your own code. To make use of Based, the 
procedures and functions must be made 
available to your program by using either 
the LIBRARY or INSTALL commands from 
Basic. Having then initialised Base5 by 
calling PROCbase5, you can then proceed to 
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WimpBase5 being used with related files, 


showing both parent and child windows open 


on the Desktop 


I must make it clear to anyone who might 
think that this provides a ready-made short 
cut to a complex database program, that a 
considerable amount of work is still involved. 
Base5 will deal with things such as opening 
and closing files; retrieving, editing and 
saving records; searching, sorting etc. 
However, it is up to you to write all the 
screen-handling routines, menus etc. (which 
means the entire Wimp interface if it is 
multi-tasking), and also the code to decide 
what to do with keyboard input, how to 
interpret the information in the database and 
so on. The advantage of this, of course, is the 
extreme flexibility it gives. The appearance of 
the database, and the way it interacts with 
the user, are entirely up to you. 


FRONT END 

WimpBased is, as its name suggests, a 
multi-tasking front end for Base5. It is 
provided to enable the package to be used as 
a database by those who do not wish to 
write their own applications, or as an 
example for those who do. Although it is 
intended for serious use, it is not the main 
reason for the existence of Based, and this 
should be taken into consideration when 
comparing it with other database systems 
on the market. 
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The application itself conforms to the 
usual format for Wimp programs, with a 
main window in which the records are 
displayed, and a comprehensive menu 
structure which allows pretty well every 
standard database function to be performed. 
For example, file manipulation includes 
open, close, discard or recall facilities; fields 
can be added, deleted or modified and so on; 
records can be added, deleted, edited, sorted 
etc. Search facilities are included, as are 
import and export using the formats 
described above, with facilities to make 
export conditional, by specifying either a 
range or a set of conditions. A Reports 
Designer is also built in, to allow you to 
print information from the database. 


An additional feature is the ability to 
relate files. Two or more files can be linked by 
a relate file; this describes which fields in the 
parent file are to be linked with which in the 
child. The manual describes clearly how to do 
this. Once the links are set up in this way, if 
a field from a parent file displayed in the 
main window has a related field in a child 
file, a second window is opened to show 
information taken from the child field. 


WimpBase5d performs competently, and 
can be used by anyone who wishes to set up 
and use a simple database with the 
minimum of effort. Indeed, there are a good 
many users who bemoan the complexity of 
some databases, and for many applications 
the uncomplicated but comprehensive 
facilities provided by WimpBase5 will be 
welcome. I had some small niggles about the 
way certain things had been done. For 
example, in a database of, say, 100 records, 
the first will be shown as “Record 0 of 100” 
and the last as “Record 99 of 100”. However, 
the author of the package is receptive to 
comment and suggestion, and is continually 
making refinements in the light of feedback 
(I understand that the criticism mentioned 
above will be dealt with, for example). 


For those who buy this database with a 
view to developing their own applications, 
WimpBase5 will also prove a very useful 
tool. It appears to be robust, and is ideal for 
creating and testing data structures while 
developing an application to handle them. I 
tried this out myself, using WimpBase5d to 
create a database of my photographic slides. 
Once I was satisfied that the data structure 


was correct, I then started to write a multi- 
tasking application to display and handle 
the information in a format more suited to 
my own requirements. This is a task I have 
been meaning to do for many years, but it 
has taken the arrival of RISC OS and Based 
to give me the confidence to tackle it. The 
result was very satisfactory: the Based 
procedures worked as they should and did 
everything expected of them. The system is 
complex, but no experienced programmer 
should have difficulty in understanding it. 


CONCLUSIONS 

This package makes a valiant attempt to 
give the Archimedes a truly programmable 
database, which can be used by software 
developers to create professional, possibly 
application-specific database systems, in 
much the same way that, in the PC world, 
programmers often build systems using 
Dbase, for example. Given the power of the 
Archimedes, it is not difficult to envisage 
that some imaginative programming and a 
little enterprise could make the Arc worthy 
of consideration in some areas where a 
tailored system is needed, such as hotel 
management or doctors’ surgeries. 


This is the theory, at any rate. My only 
reservation is that, in trying to cater fairly 
and squarely for the average Archimedes 
programmer, Based is written in Basic. 
Rightly or wrongly, Basic is not generally 
seen in the computer world at large as a 
suitable language for writing major 
applications, though thankfully Based is at 
least fully compatible with both Basic 
compilers. Indeed, it is more difficult to 
write Wimp-based programs on the Arc in 
Basic than in C, for example, though 
certainly not impossible. My fear is that this 
will discourage the very people at whom 
Base5 should be aimed: programmers 
experienced at writing applications on other 
systems who see the Arc market as an 
exciting and worthwhile new venture. I hope 
this will not be the case, because we 
desperately need more powerful and 
professional business software for the Arc to 
make its presence felt in serious circles. 


Product Base5 DBMS 
Supplier Bases 
PO Box 378 
Woking, Surrey GU21 4DF. 
Price £69.00 ine. VAT. Ay 
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by Majid Anwar 


ith RISC OS’s excellent printer 

drivers, making labels for your discs 
is simple. This article explains how to 
produce professional looking labels with 
relative ease, using the basic packages 
provided on the RISC OS Applications discs, 
coupled with any printer ranging from a 
humble dot-matrix right up to a powerful 
PostScript machine. 


MATERIALS 


In addition to your Archimedes, you'll 
need a printer (but see later), the Draw 
application (on the Appl disc), a printer 
driver (also on Appl), and something to 
print on. You might also want to use Paint 
(App! again), but more about that later. The 
label itself can be made from any of the 
following, depending on your time and 
finances: 

1. Plain paper with: 

a. double-sided tape 
b. rub-on adhesive (e.g. Pritt) 
c. spray-on adhesive (e.g. UHU) 


2. An Ad ‘sheet label’ e.g. Canon 
Copystock or Crackback 


The advantages of the former option 
are that it’s cheap, and tinted paper can 
also be used. The latter, although more 
expensive, is simpler to use and less 
messy. Finally, you might like to use 
some clear sticky-backed plastic/ 
cellophane to cover the finished label, 
giving it a glossy appearance. This is 
especially useful if you are using a water- 
soluble inkjet printing system. 


CREATING THE LABEL FILE 

This section assumes that the user is 
familiar with both RISC OS (i.e. use of the 
pointer, dragging , etc.), and the Draw 
application. Remember to save your work 
regularly during this session. Start with a 
new document in Draw and create any 
rectangle somewhere on the page. Now, 
resize this precisely, thus: 


Select the rectangle to edit it. The 
rectangle will be replaced by 4 blue nodes at 
the corners connected by 4 grey lines. Click 


(1.0, 8.0) 


(1.0, 2.6) 


7? ee > = 
(1.0, 2.3) 

WRITE PROTECT 

WRITE ENABLE 
(1.0, 1.0) 


over the top-left node using the Adjust 
button, and then Select Enter coordinates 
from the menu. A small window should open 
up displaying the co-ordinates of the node 
relative to the bottom-left of the page. Select 
the centimetre option and replace the co- 
ordinates shown with x=1.0 and y=1.0 and 
then click on OK. Do the same with the 
other three such that top-right = (8.0, 8.0); 
top-left = (1.0, 8.0) and bottom-right = (8.0, 
1.0). You should now have a rectangle 
measuring 7cm by 7cm: the exact size of a 
3.5” dise label (it may not look this size on 
screen). This is the basic label outline in 
which any design may be placed. Fig.1 
shows the dimensions for some ‘landmarks’ 
on a standard disc label. You can place and 
size them precisely using the co-ordinate 
method explained above. 


(8.0, 8.0) 


(8.0, 2.6) 
(8.0, 2.3) 


(8.0, 1,0) 


Figure 1. A ‘standard’ 3.5 inch disc label; 


all measurements are in cms (the ‘spine’ Is 


another rectangle) 


Copy the outline and place several on 
the page, but remember to stay away from 
the edge, as your printer will probably have 
a margin in which it cannot print. Load 
your printer driver (see below) and choose 
show printer margins from the Draw Misc 
menu to see the border. You can now 
proceed to design your disc label using all 
the features of Draw (see example in Fig.2), 
but make sure any fonts you need have 
been installed first. 

Continued on page 28 
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See your free memory at a glance with this application from Majid Anwar. 


n order to see the amount of free 

memory left in your Archimedes, it is 
normally necessary to open the Task 
display window from the Task Manager 
(the A-shaped icon at the right of the icon 
bar). The total amount of free memory is 
made up of the Next and Free slots shown 
on the Task display. 


FreeSlots enables you to see this 
information continuously updated on the 
icon bar, without needing to open the Task 
display window. It works by first replacing 
the Task manager icon with a new icon 
consisting of a blank sprite, and then 
redirecting VDU output to this sprite to 
display the values of the Next slot and the 
total free memory (i.e. Next + Free). 


CREATING THE APPLICATION 


First create an application directory 
called /FreeSlots. This will require a 
suitable application sprite, contained 
within a /Sprites file, and also a /Run 
Obey file with the following lines: 

IconSprites <Obey$Dir>.!Sprites 

WimpSlot -min 8K -max 8K 

Run <Obey$Dir>. !RunImage 
If you are unsure how to create an 
application directory the simplest method 
is to use our Application Shell Generator 
(Volume 3 Issue 2 or Volume 3 Special 
Disc). 


Next, type in the listing given here and 
save it in the application directory with 
the name /RunImage. Finally, you need a 
blank sprite to replace the Task manager 
icon sprite. Using Paint, create a sprite of 
width 38 and height 17. Fill this 
completely with colour 1 (light grey), 
name it switcher, and save it in a separate 
file in the application directory. For 
convenience you can also call this file 
Switcher, but it can have any name 
provided that you alter line 120 of the 
program to reflect the name you choose. 
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USING THE APPLICATION 

Double-clicking on the !FreeSlots icon 
in a directory viewer will install the 
application, and after a short pause you 
will see the Task manager icon change to 
display two figures in place of the usual 
icon. The upper figure, in red, shows the 
current value of the Next slot, while the 
lower figure, in green, shows the total 
amount of free memory. As you install or 
remove applications you will see the 
figures change. As well as displaying this 
information, the new icon still performs 
the same function as the A-shape it 
replaced, so you could open the Task 
display window and see what happens as 
you drag the Next slot up and down with 
the mouse. 


You can only remove the FreeSlots 
application from the Task display window. 
To do this, click Menu anywhere along the 
line occupied by FreeSlots in the 
Application tasks section of the window, 
go to the submenu for the task, and select 
Quit. The original Task manager icon will 
now be restored to the icon bar. 


10 REM >!RunImage 
20 REM Program Free slots 
30 REM Version 1.00 

40 REM Author Majid Anwar 


50 REM RISC User March 1990 
60 REM Program Subject to copyright 
10° 

80 ON ERROR PROCerror:END 

90 DIM q% 255 

100 quit%S=FALSE 

110 SYS "Wimp Initialise", 200, &4B53415 
4,"Free slots" 

120 *Iconsprites <Obey$dir>.switcher 

130 : 

140 REPEAT 

150 SYS "Wimp Poll", %1111111111110,q% 
TO reason’ 

160 CASE reason% OF 
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FreeSlots 
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170 WHEN 0 : PROCupdatesprite 

180 WHEN 17,18 : quit3=(q3!16=0) 

190 ENDCASE 

200 UNTIL quit’ 

210 SYS "Wimp BaseOfSprites" TO ,ramsp 
xr 

220 SYS "OS SpriteOp",&119, ramspr%, "sw 
itcher" 

230 !qb=4:qi!4=5:q$!8=11 

240 q$!12=12:q$!16=-1 

250 SYS "OS _ReadVduVariables",q%, q3+32 

260 xb=qt! 40*2%qs!32:yt=q% !44*2%qt!36 

270 SYS "Wimp ForceRedraw",-1,0,0,x%,y 


280 SYS "Wimp _CloseDown" 

290 END 

300 : 

310 DEFPROCupdatesprite 

320 SYS"Wimp SlotSize",-1,-1 TO ,next$ 
, free} 

330 IF next$>free$ next i=free% 

340 SYS "Wimp BaseOfSprites" TO ,ramsp 


The use of sprites deserves special 
mention: sprites can be dropped directly on to 
a Draw document but can only be modified 
within Paint, An application’s own sprite 
may be loaded by pressing 


ri 

350 SYS "OS SpriteOp", 613C, ramspré, "sw 
itcher" TO RO,R1,R2,R3 

360 GCOL1:RECTANGLEFILL 0,0,76, 64 

370 GCOL11 

380 PROCprint (STRS (next $/1024)+"K", 60) 

390 GCOL13 

400 PROCprint (STR$ (free%/1024)+"K", 28) 

410 SYS "OS _SpriteOp",RO,R1,R2,R3 

420 !q3=-1:q5!4=0:qt!8=0:q%!12=0 

430 SYS "Wimp SetIconState", ,q% 

440 ENDPROC 

450 : 

460 DEFPROCprint (aS, y$) 

470 VDUS:MOVE 36-LENa$*8, y$:PRINTaS 

480 ENDPROC 

490: 

500 DEFPROCerror 

510 ON ERROR OFF 

520 SYS "Wimp CloseDown" 

530 PRINT REPORTS" at line ";ERL 

540 ENDPROC AU 


Creating Professional Disc Labels with Draw (continued from page 26) 


PrinterPS - the PostScript driver. Set this to 
‘file’ output (as opposed to parallel or serial) 
and enter a path to where you want the 
printer driver to create its file. Now print as 
normal and a PostScript 


Shift while double-clicking 
over the application and 
loading the !Sprites file into 
Paint. The relevant sprite 
(and maybe others) will 
appear in a window. Choose 
the sprite and ensure the 
Palette option (in the Edit 
submenu) is on. Now, save 


file will be created. Finish 
off by selecting parallel or 
serial again. This 
PostScript file can be taken 
to any PostScript 
compatible printer in- 
cluding powerful photo- 
typesetters at your high 
street printing shop. First, 


this sprite (not the whole 


however, use an IBM disc 


file) and drag it onto the 
Draw window. Position and 
size it as required, 


PRINTING 

There are three ways to print your newly 
created disc label. Firstly, you can print it 
yourself. Remember to turn the 
Monochrome option off if you are using 
colours or sprites. Secondly, you can take 
your file to another Archimedes (perhaps 
with a better printer) and print it there. 
Finally, and most ambitiously, you can use 


Figure 2. Sample 3.5" disc label 


reader (for example, PC 
Disc Reader from the 
Volume 3 Special Disc) to 
copy the file onto an IBM 
disc (which is the industry 
standard for these professional machines). 
Of course, if you have your own PostScript 
printer, the quality of its printing may be 
more than good enough for your needs. 


Other labels can be produced in a similar 
way (e.g. 5” discs, videos, cassettes etc.), all 
with the same professional result. AY 
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Canon BJ-10e Printer 


Alan Wrigley looks at Canon’s new baby bubble jet. 


improbable. Measuring just 12 x 8.5” 

eé same size as an A4 sheet of paper) 

and about 2” thick, it would easily pass for 

a smart software package. Yet the BJ-10e 

is an 80-column bubble jet printer which 

lacks none of the features normally found 
on full-size machines. 


THE PRINTER 

The BJ-10e looks very smart, and is 
available in two colours, mid-grey (called 
black) and beige (called white), As well as 
being small, it is also very light in weight 
(about 4 lbs, or less than two bags of 
sugar). This has been achieved partly 
by the use of very light plastic for the 
case. At first sight this appears to be 
extremely flimsy, and flexes alarmingly, 
giving the impression of poor quality. 
However, this is quite deliberate: the 
printer has been designed first and 
foremost with portability in mind, and a 
flexible casing is less likely to be 
damaged if dropped or knocked in 
transit, 


t first sight the Canon BJ-10e looks 
fs 


The BJ-10e is powered either from a 
separate mains adaptor (which is 
supplied) or from batteries which fit 
into the rear of the machine. An 
optional NiCad battery pack is available 
for the latter purpose. This enables the 
printer to be used virtually anywhere and 
thus makes it the perfect companion for a 
laptop portable computer, while still 
offering all the facilities required of an 
office printer. A parallel Centronics 
interface is fitted as standard. The 
package is completed by a slim User’s 
Manual. 


The bubble jet technology is a Canon 
speciality. It is similar to that of other ink 
jet printers except that the ink is expelled 
by heating a bubble which forces the ink 
out, rather than by spraying. Ink jet 
printers have three main advantages over 
dot matrix printers. Firstly, they are 
extremely quiet in operation. Secondly, 
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they are potentially more reliable since 
there are no moving pins to wear out or 
become damaged. And thirdly, print 
density is consistent throughout the life of 
the ink cartridge. Compare this with a dot 
matrix, where the print might be black for 
the first few pages with a new ribbon, 
then becomes an increasingly lighter 
shade of grey until you decide you can't 
read it any more. The main disadvantage 
is the cost of the ink cartridge, which 
works out around 4p per sheet, compared 
with about 1-2p for a dot matrix printer 
(depending on how often you change the 
ribbon!). 


The BJ-10e In horizontal mode 


THE BJ-10e IN USE 

The first thing to be aware of when 
using this printer with an Archimedes is 
that you will need a RISC OS printer 
driver which supports the BJ-10e. 
PrinterDM can do this, but only if the BJ- 
10e is included in the list of printer 
definitions. BEEBUG can supply a version 
of PrinterDM suitable for the BJ-10e 
(which is free if you buy the printer at the 
same time). If you are using the BJ-10e 
with applications which print without the 
aid-of the RISC OS drivers, you may have 
a few problems since, although many of 
the printer codes used by the Canon are 
Epson-compatible, not all of them are. For 
example, italics are not supported, and 
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international character sets are treated in 
a different way, which makes it well nigh 
impossible to obtain a pound sign when 
printing text files (though if you have 
PrinterDM version 2.44 this can be cured - 
see the review of the new printer drivers 
in Volume 4 Issue 3). In fact, the manual 
suggests the IBM Proprinter X24E as the 
nearest equivalent. The manual gives 
little information about printer codes, 
other than to simply list them. However, 
Canon does supply a Programmer's 
Manual (£8.00) for those users who need 
to delve more deeply into the subject. 


The BJ-10e In vertical mode 


The printer can be used either 
horizontally or vertically (see photographs). 
In horizontal mode the open printer case 
acts as a guide and support for the paper, 
which is fed in from the top like a 
conventional printer. When used vertically, 
the paper is fed into a slot in the back. This 
is useful for printing envelopes and other 
thick items which will not go through the 
necessarily tight path which is a 
consequence of the small roller. Since the 
case has to be open for the paper to emerge 
(and thus must lie flat in front of the 
printer), there seems to be little space 
advantage in using it vertically, until you 
realise that this is a clever way of providing 
a compact auto sheet feed facility. An 
optional auto sheet feeder, not much larger 
than the printer itself, fits onto the rear of 
the BJ-10e in the vertical position and 
feeds the paper through the rear slot. 


PERFORMANCE 

To assess the performance of the BJ- 
10e, I compared it directly with a good- 
quality dot matrix printer, the Star XB24 
(see the review in Volume 3 Issue 9), and 
with the HP DeskJet 500, a popular ink 
jet printer costing more than the BJ-10e 
and about six times the size. For interest, 
I also compared it with the Qume 
CrystalPrint Publisher, which is a 
PostScript printer. I chose two Draw files, 
one of which I have used before in 
comparative tests (e.g. the LaserDirect 
and the ArcLaser, Volume 3 Issue 8 and 
Volume 4 Issue 1 respectively). The 
picture is of a plant, and contains areas of 
shading in various densities, including a 
block of dense colour. The other file was a 
technical drawing containing a lot of fine 
detail. Both these files were printed at 
360x360 dpi on the Canon and Star, and 
300x800 dpi on the Qume and DeskJet. 


The results of the tests took me 
somewhat by surprise. The output from the 
Qume was crisp and sharp, as would be 
expected, though with natural subjects, 
such as the plant, the clinical half-tone dot 
patterns do not necessarily enhance the 
subject. With the technical drawing, some 
of the fine lines were far too thick and bold, 
degrading the image in some places. The 
DeskJet coped with fine lines admirably, 
and reproduced both pictures to a high 
degree of precision. However, I felt that the 
plant still lacked life, and the lines on the 
technical drawing looked a little weak 
(though for very intricate work this would 
be an advantage). The BJ-10e, on the other 
hand, produced superb results from both 
files, and I have to say that, subjectively, I 
preferred the output to both the Qume and 
the DeskJet. Fine lines were crisp and 
clear, while dense areas were admirably 
reproduced as a solid block of colour. 


The XB24, as might be expected, was 
not in the same league, producing a result 
which was unmistakably from a dot matrix 
printer, though better than many. The tell- 
tale horizontal lines and slightly crinkled 
paper, which are the result of impact by the 
printer pins, were particularly noticeable 
across the plant. Surprisingly though, the 
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XB24 was faster, reproducing the plant in 2 
mins 55 secs as opposed to 4 mins 50 secs 
for the BJ-10e and 3 mins 25 secs for the 
DeskJet 500 (the Qume, being a postscript 
printer, is in a different league in terms of 
speed, producing the same printout in 
around 50 secs). 


Text printing on the BJ-10e is 
reasonably fast (83 cps is claimed) and 
produces an attractive and crisp result in a 
Courier font. The only other fonts available 
are Prestige elite and proportional spacing, 
though since the standard Epson codes are 
not used for these, it will be difficult to 
make use of them. However, more and 
more applications are taking advantage of 
the RISC OS drivers, so the lack of fonts 
built into the printer should not worry 
most Archimedes owners. 


CONCLUSIONS 

If you think printers should look big 
and hunky, then the BJ-10e is not for you. 
But if you have no such pre-conceived 
notions, then it is most definitely worthy 


lan Copestake Software 


of consideration. Indeed, if portability or 
silent operation are important to you, and 
if you do a lot of graphics printing and 
find the image quality from a dot matrix 
unacceptable, then the BJ-10e is probably 
the best choice on the market at present. 
It is cheaper than other ink jet printers, 
and a lot cheaper than a laser printer, yet 
the print quality is virtually as good as 
both of these. Canon has a real winner 
here, and provided that you plan to use it 
primarily with a RISC OS driver, then I 
can strongly recommend it. 


Product: BJ-100 bubble jet printer 


Suppiler: Canon (UK) Ltd. 
Canon House, 2 Manor Road, 
Wallington, Surrey SM6 OAJ. 
Tel: 081-773 3173. 

Price £333.45 inc. VAT 


(BEEBUG retail price). 


A version of PrinterDM suitable for the 
BJ10e is available from BEEBUG, costing 
£17.25 inc. VAT (supplied free when you 
buy the printer). The auto sheet feeder is 
also available at £62.10 inc. VAT. RU 


Cambridge International Software Ltd 
ARCHIMEDES SPRING FAIR 


March 9" & 10" (Sat & Sun) 1991 
10am-5 pm 


at 


8 HERBRAND ST 


LONDON WCIN 1HZ 


100's of Archimedes products - Hardware, Software, 


Callig raph 
Digital Services 


Consumables, Demonstrations, Seminars 
Educational software for all levels 
Open to dealers and the public 


071 833 4023 
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/f you are looking for a hard drive for your Archimedes or A3000, why not consider using a 
| MicroNet MR45 removable hard drive ?... 


Norwich Computer Services has a range of over 40 discs of Archimedes public domain 
software from various sources. Many of the discs contain several quite substantial applications 
for as little as £3.50 per disc. Some of the more popular applications are... 


Ring, write or fax us if you want a full list of our PD software. 


96a Vauxhall Street, Norwich NR2 2SD. (0603—766592 / Fax 764011) 


42M Removable Drives — £585 


Fast — The average access time is 25 milliseconds, so these are FAST devices. When used 
with an Oak SCSI card, the file transfer rate is the same as a standard 45M hard drive. 
Reliable — The technology of these drives has been proven by use in huge quantities on the 
Apple Macintosh computers. 

Robust — The discs, when not in the drive, are extremely robust. We (deliberately!) threw 
one half-way across the office, it dropped on the floor and rolled over a couple of times. We 
then verified it and found that it did not have a single error on it! 

Flexible —The medium is removable, so you can use different discs for different uses, each 
with its own boot file — one for DTP, one for games etc. 


Physically secure —The medium is removable, so you can take out the disc and lock it up 
in a safe place. 

Secure data — The discs can be write protected, like floppy discs, to protect the data. 
Cheap — The price of the drive, including a single 42M disc, is just £585 (£680 including 
VAT and carriage). Extra 42M discs are £80 each (including VAT & carriage). 


Public Domain Software 


!PCDir — A desktop utility that allows the transfer of files between MS-DOS discs and 
Archimedes discs. (One of many programs on Careware N°7 — £7. The aim of Careware 
discs is to raise money for charity. For each disc, £6 is sent direct to charity.) 


!Translator — This application allows you to translate between various image file formats 
— sprite, GIF, TIFF. (Shareware N°21, £3.50, which also has other graphics applications.) | 
!Draw+ is an updated version of !Draw with many extra features including keyboard short- 
cuts. (Shareware N° 34, £3.50, which also has !Draw lineart and other DTP utilities.) 
Keystrip printer — Creates !Draw keystrip from an ! Edit file of the text. (Shareware N°32, 
£3.50 — also has a lot of other DTP stuff on it.) 

YAIG — Yet Another Invaders Game — excellent implementation. (Shareware N°16, £3.50) 
DOS filing system and DFS reader/writer — These are available on Shareware N°31, 
£3.50, which also has a *C’ editor and various other utilities. 
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Programmer's Workshop 
Understanding E-Format Discs (Part 2) 


David Spencer continues his look at the structure of RISC OS E-format 


discs. 


In last month’s article we took a look 
at the principles on which E-format discs 
are based, and looked at the layout of the 
bitstream map that indicates what each 
chunk of disc storage is used for. In this 
article we will finish looking at the map 
by showing how its checksum is 
calculated, and then move on to look at 
the layout of the directory tree. Finally, we 
will study the allocation strategy that 
RISC OS uses to ensure the minimum 
amount of file fragmentation, and the 
fastest possible access to files. 


THE MAP CHECKSUM 


As you will remember from the layout 
of the disc map given in the previous issue, 
the first byte of each map zone contains a 
checksum for the zone. This is used to 
detect any corruption of the map, which is 
handled in a manner described later. 


The checksum of a zone is calculated 
by effectively adding together the values 
of all the words in the zone, excluding the 
checksum byte itself. The arithmetic is 
performed modulo-32, with any carry 
being added back in. Below is a suitable 
algorithm in pseudo-code. 


Point to end of map 
Zero Carry and Total 
REPEAT 
Read 32-bit Word from map 
Total = Total + Word + Carry 
IF Total >= 2°32 
Total = Total - 2°32 
Carry = 1 
ELSE 
Carry =0 
UNTIL all words in zone read 
Subtract old checksum from Total 
Split checksum word into four bytes 
Exclusive OR four bytes together 
to give checksum 


This month’s magazine dise contains 
an assembly language implementation of 
the above algorithm. This should be called 
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with register R1 pointing to the start of 
the map zone in memory, and R2 
containing the length of a map zone (in 
bytes). The routine exits with R14 
containing the single byte checksum. The 
routine can also be used to check an 
existing checksum with the result being 
returned in the Z flag. If the Z flag is set 
then the checksum for the zone is correct. 


Because corruption of the disc map 
would effectively render every file on the 
disc unreadable, RISC OS takes 
precautions to prevent corruption of the 
map, which could easily occur if the 
computer was reset while updating the 
map. What is done, is to keep two adjacent 
copies of the map. Normally, RISC OS only 
reads the first copy, but will write both 
copies whenever the map is updated. The 
*Checkmap command checks the integrity 
of the map against the actual disc contents, 
and if it is corrupt allows you to overwrite 
the first copy with the second. 


THE DIRECTORY STRUCTURE 

Having looked at the map struture, we 
can now move up a level and examine the 
format of the directory structure. We will 
primarily look at the directory structure 
used on E-format discs, though the only 
difference between this and D-format is 
that the latter contains the absolute disc 
addresses of files, while the former holds 
file numbers instead. The directories used 
by the obsolescent L-format are different, 
and will not be examined. 


On E-format discs, directories are 2048 
(&800) bytes long. This means that they 
occupy two sectors on a floppy disc, and 
usually eight on an ST506-type hard disc. 
Within a directory, any sub-directories are 
simply treated as 2048-byte files, with a 
special bit in the directory entry set to 
indicate that it refers to a sub-directory 
and not a normal file. 
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The layout of data within a directory 
is: 


Contents 

Master sequence number 
1-4 Directory identifier 

6-30 First directory entry 
31-56 Second directory entry 


Offset 
0 


Final directory entry 

0 (end marker) 

reserved 

File number of parent 
Directory title 

Directory name 

Master sequence number 
Directory identifier 
Directory checksum 


1981-2006 
2007 
2008-2009 
2010-2012 
2013-2031 
2032-2041 
2042 
2043-2046 
2047 


As you can see, the bulk of the 
directory is made up of the 77 possible 
entries, with a header at the start, and 
additional information at the end. If less 
than 77 entries are present, the end of the 
list is marked by a zero byte in what 
would be the first letter of the next 
filename. The directory identifer is the 
text string ‘Nick’ (after the programmer 
responsible), and is used to check that it is 
indeed a directory. The master sequence 
number, which also appears twice in the 
directory is a value which is incremented 
each time the directory is changed. If the 
two copies differ, the directory is deemed 
corrupt, and a ‘Broken Directory’ error 
given. The directory checksum is similar 
to the map checksum, but the calculation 
is more complicated. An assembly 
language program to calculate and check a 
directory checksum is given on this 
month’s magazine disc. 


The file number of the parent is used 
for *Up, or * in a pathname to locate the 
parent. The directory title is a nineteen 
character long string set by *Title, while 
the directory name is the leafname used to 
represent the directory in the parent. Both 
of these are displayed when a directory is 
catalogued. 


Each directory entry itself consists of 
twenty-six bytes, organised thus: 


Contents 
Filename 

Load address 
Execution address 


Length 
File number 
Attributes 


The ten-character filename is terminated 
with a carriage return if shorter than the 
maximum length. Most files under RISC 
OS will be date stamped and typed, rather 
than having absolute load and execution 
addresses. In this case, the load and 
execution address fields are replaced by 
&FFFtttdd and &dddddddd respectively, 
where ttt is the filetype, and dddddddddd 
is the time in centiseconds since the start 
of the century. 


The file number was explained last 
month, and consists of the file number 
proper and possibly a sector offset within 
the cluster. Finally, for the directory entry, 
the atrributes byte indicates the access set 
by *Access, and also whether the entry 
refers to a file or a directory. The meaning 
of each bit is: 


Bit 0 Set for R access 
Bit 1 Set for W access 
Bit 2 Set for L access 
Bit 3 Set to indicate a directory 


The root directory, $, is always grouped 
together with the two copies of the map to 
form file number 2. For example, on a 
floppy disc, where each map copy takes 
one sector, the file number of the root 
directory is &203, meaning the third 
sector in cluster number two. Having 
located the root directory, it is a simple 
matter of scanning its entries to locate the 
files contained within it, and the sub- 
directories. This can then be applied 
recursively to the sub-directories, meaning 
that having located the root, any file in 
the directory struture can be located. 


ALLOCATION STRATEGIES 


It is all very well defining the 
representation of the disc map and 
directory structure, but one important 
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topic we have not considered yet is how 
RISC OS allocates the storage space on 
the disc. 


In pre E-format discs, the allocation of 
disc space was simple. Each time a new 
file was saved, the operating system 
searched through the map until a large 
enough block of free space was found. Any 
gaps formed by deleting files remained as 
gaps until filled by a new file of the same 
length or shorter. This system has two 
major drawbacks. Firstly, if an attempt 
was made to extend a file that was 
trapped between two others, then nothing 
could be done if the space was not 
available, and the operation was aborted 
with an error. To avoid this, files created 
for random access were allocated vastly 
more space than they would probably 
need, in order to give the file room to 
expand. For example, RISC OS ADFS 
used to allocate 64K for each random 
access file when it was created. 


Secondly, when saving a file no attempt 
was made to minimise fragmentation of the 
disc space. For example, if a 15K file was 
deleted, and a 14K one saved immediately 
after, the new file would probably fit in 
place of the old one, leaving a small 1K 
fragment that would only be filled if a file 
shorter than 1K was then saved. This 
quickly led to the disc becoming 
fragmented, and the *Compact command 
was needed to tidy it up. 


E-format dises are entirely different 
with a different allocation strategy. For 
one thing, as we saw last month, files can 
be fragmented into a number of sections if 
need be. This means that there is no 
longer a need to over-allocate space when 
creating a random-access file. However, 
this leads to more problems, because if not 
managed properly you quickly end up 
with a large number of fragmented files 
that take longer than necessary to access. 


For this reason, Acorn have designed 
an allocation strategy that aims to reduce 
file fragmentation, and speed up access. 
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This strategy only really applies to hard 
discs, which have more than one zone in 
the map. Directories are allocated from 
the middle zone outwards; hence the root 
structure will appear somewhere close to 
the middle of the disc. Whole files (not 
those created using OPENOUT) are 
placed in the nearest zone to their parent, 
working out in either direction. This 
achieves the very important goal of 
keeping files close to their parent 
directory. When these files are accessed, 
head movement, and hence access time, 
will be reduced, as the file is as close as 
possible to its parent. 


The situation with OPENOUT is more 
difficult, as random access files tend to 
change in length, and therefore require a 
different strategy. In this case, RISC OS 
searches the map zones making a trade off 
between how far out from the parent zone 
it must move and how much free space is 
in the zone. In other words, it trades fast 
access by being close to the parent against 
the possibility of having to fragment the 
file, caused by choosing a zone with not 
enough free space. 


All this is OK provided the required 
space can be found. If it can’t, RISC OS 
must decide whether to fragment the new 
file, or to move other files about to make a 
suitable gap. RISC OS contains a very 
efficient compaction routine that can 
quickly calculate how to move fragments, 
and then move them with the minimum 
fuss, When saving whole files, compaction 
continues until a large enough gap is 
formed, or the data moved about on the 
disc is over twice the length of the file 
being saved. In this latter case, the file is 
fragmented into adjacent gaps, to 
minimise head movement between one 
fragment and the next, Random access 
files are only compacted when opened or 
closed, and then only if a very good 
opportunity exists. The net effect of this is 
that whole files are hardly ever 
fragmented, and long-lived random access 
files which may start fragmented tend to 
recombine as time goes by. AU 
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Disc 7 - A Chess Program for The Archimedes. 

A Chess program that takes full advantage of RISC OS, installing itself on the icon 
bar and running on the desktop in a window at the same time as other 
applications. You can carry on working whilst the program is thinking of its move. 
Features: load and save games, edit board, step backwards and forwards through 
game, computer ‘v' computer mode, play black or white, reverse board, save 
game. multiple levels, print game. Algebraic notation. Full mouse control, on 
screen clocks. Hint. Choice of piece when promoting pawn. Undo move. 


Disc 16 - A New Spark RISC OS Archive program 

Spark, allows you to store files and directories in archive files in a very 
compressed form. e.g. sprites often take up only 10% of normal space. Files in 
archives, can be accessed just like files in disc directories. Now new Spark series 
2.XX, has lots more features. Background operation - archive whilst you do 
something else. Reads all these formats, zoo, zip, Izh, UNIX and Archie Tar, 
Compress. Reads and writes PKarc, SEA/PC arc, uucode, atob/CET+, FCET and 
Archimedes archives. New 16 bit higher performance compression. Script files, 
message driven operation. DES data encryption. Full info, sort by type etc. 


Disc 22 - Novapaint 16 colour paint package. 

Paint package with two tone font system. user defined brushes, airbrush, auto- 
shader, colour fills. define graduated palettes. pixel average, area squash/ 
stretch/distort/rotate. sphere wrap, cylinder wrap. Online help, manual, demos. 
New version uses full screen for editing, but allows file load/save from desktop. 


Disc 24 - RISC OS Desktop Multitasking Terminals 

Bring Archie comms to the desktop, Stay online whilst using other programs. 
Good quality high speed, Viewdata and ANSI/VT220/100/52 emulations. Sult 
Prestel, bulletin boards and mini/mainframes. Auto logon scripts. CET, ASCII and 
x/Ymodem (batch), file transfer. RISC OS printer driver support. |RS423state. 


Discs 12 and 26 - The World and World Map 
Database of 130,000 coordinates of points on Earth and !WorldMap to convert the 


data into !Draw file maps which can be imported into Draw, Ovation etc. 
(Discs 12 and 26 bought together cost £6.99 and then count as one disc). 


EMACS. Classic multi document editor with macro language. Includes full C source, 
XLISP, Object oriented version of LISP complete with C source code. 

C Toolkit. 20+progs for C programmers with sources. grep, awk, make, sed, more... 
Kermit. Archimedes, BBC and MSDOS versions of file transfer/communication. prog, 
More C Tools. yacc and lex with examples and C source. New versions... 

Starchart. RISC OS program to make Draw file starmaps. Catalog of 9000 stars. 
!Pcompile. Desktop wimp based front end for ISO Pascal compiler. 

XLIB. Library of extensions for Pascal. Interface to wimps etc. Lots of Pascal progs. 
PipeDream Extras. 250,000 word US English dictionary, Printer buffer, and autosave 
(automatically saves documents every so often). Needs hard disc for dictionary. 


Each disc is £5.99 inclusive. Buy four claim another one free! 
David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail delivery on overseas orders. ‘Full list available on request. 


Into the Arc 
RISC OS for Beginners 


This month we get right down to basics with a topic about which we 
receive many queries, and that is the use of !System. This clearly 
causes a lot of confusion for many users. Mike Williams deals with this 
topic using a question and answer approach. 


I often see references to !System. What 
is this? 


!System, also referred to as System 
Resources, is provided as an essential part 
of RISC OS for the Archimedes, and is to be 
found on Applications disc 1. Its function is 
to provide a number of resources which are 
needed (shared by) many Applications. 
These resources are usually in the form of 
modules kept in a separate Modules 
directory within the !System application 
directory. There are three such modules 
provided as standard, CLib (which is the 
C language library, required by all 
programs compiled from C source code), 
Colours (which handles colour 
translation for Desktop programs), and 
FPEmulator (which implements floating 
point arithmetic operations on the 
Archimedes). 


If so many programs need these 
resources, why are they not 
included with the rest of RISC OS 
so that they are available as soon 
as the machine is switched on? 


This would be ideal, but would 
cause problems if and when any of the 
resources are updated (as has already 
happened with CLib and FPEmulator). 
It would also prevent other system 
resources (which are supplied with specific 
applications) from being incorporated into 
the same system. 


OK, so what doI do with !System? 


!System is supplied on Applications 
disc 1. When you first switch on your 
machine, insert this dise and open its 
directory viewer to show the !System icon. 
Once this has been done RISC OS has 
‘seen’ System Resources, so should any 
subsequent application require any of the 
modules it contains you will be asked to 
re-insert Applications dise 1 for the 
relevant modules to be loaded. 
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If you have a system with a hard disc, 
!System is normally stored in the root (top 
most) directory of the hard disc. Opening 
this directory, or configuring your machine 
to boot the hard disc when the system is 
first switched on, will ensure that !System 
is always seen by RISC OS. Subsequently, 
any request for System Resources can be 
met straight away because RISC OS 
knows where it is located, and it is 
immediately accessible. 


'Draw SEdit 'Fonts 
‘st 

(% 

1Paint —-{PrinterLJ !PrinterPS 


Typical contents of !System and the modules 


directory 


Of course, if you press Ctrl-Break at 
any time you effectively reset your 
machine, so its knowledge of !System will 
also be lost (unless Ctrl-Break reboots a 
hard disc as described above). 


In addition, if you want to ensure that 
RISC OS uses a particular copy of 
!System, then open the relevant directory 
viewer for this version and double-click on 
the !System icon. Note that, by default, 
this action in itself will not load any 
modules from !System. Properly written 
applications will always check whether a 
module is already in memory before 
attempting to load a module from 
!System. 
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That all sounds fairly straightforward. 
However, I sometimes see the message 
Picaad Resources not found”. Why is 
that 


This will usually only happen if you try 
to run an application which needs to use 
one of the !System modules, but RISC OS 
has not seen the directory viewer 
containing !System, so it doesn’t know 
where to find it. To overcome this possible 
problem, some applications come with 
their own copy of !System on the same 
disc, so once you open the directory viewer 
for the application, RISC OS will also 
have seen !System as well. 


rely on every purchaser having the latest 
version of each module. Thus a copy of 
{System with the latest version is often 
supplied with the application. 


In addition, some applications require 
modules which are not supplied as 
standard with each Archimedes. One 
example is ABCLib which is required by 
Basic programs compiled with the ABC 
compiler from Dabs Press. This was 
required by Genesis from Software 
Solutions which used ABC to compile its 
Basic version of Genesis. 


The problem that arises with this 
approach is that any !System supplied 
with another application may well contain 
only the modules needed by that 
application. Suppose you have used 
Genesis as above, and then try to run 
some other application. You may well 
encounter an error message because the 
second application needs to refer to 
System, but as far as RISC OS is 
concerned the copy it has seen (and hence 
the one for which it asks you to load the 
disc) is the one supplied with the first 
application. This !System may not contain 
the modules (or versions) needed by the 
second application. 


" teeter 1.84 Feb 1989) 
odute tat Mecaagetrany S186 {ED Feb 1990) 


Another example of what can happen, 
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Finding module names and version numbers 


Does it matter then if I have more than 
one copy of !System on different discs? 


In an ideal world, only one copy of 
{System would ever be needed, and hard 
disc users in particular would have no 
further problems. The question to ask is 
really not ‘Does it matter?’ but ‘Why do 
some applications have their own copy of 
!System if one is supplied with every 
Archimedes?’ There are two answers to 
this, and it is here that the concept of 
shared resources starts to come a little 
unstuck. 


Some applications require an updated 
version of one or more modules. Although 
Acorn will normally ensure that the copy 
of !System supplied with each Archimedes 
is updated when a new version of any 
module is released, no software house can 


is that the version of !System which RISC 
OS has seen may not contain the latest 
version of a module needed by the 
application you are trying to run, and you 
will get a message along the lines of “CLib 
version 3.5 or later needed”. You may have 
that version, but if it’s not in the copy of 
!System that RISC OS has seen, then 
RISC OS can’t find it. 


This now sounds very confusing. 
Apparently I may have different 
versions of !System on different discs, 
but RISC OS doesn’t know which one 
to use most of the time. Is there any 
way of making life simple again? 


There are two things that will help you 
and your Archimedes to run more 
smoothly. First of all, try to keep the 
number of copies of !System to a 
minimum. If you have a hard disc, then 
you are fortunate, and you should keep 
one single copy of !System in the hard 
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disc’s root directory (with a backup on a 
floppy) - but see the second point. 


The other and most crucial thing you 
can do is to ensure that all the copies of 
!System which you have are identical, that 
is that they contain the same (and latest) 
versions of the same set of modules. To do 
this, I suggest you keep one master copy of 
{System (it could be the one on Apps 1) 
and a list of those discs which contain 
another copy. Whenever a module is 
updated to a later version or a new 
module added to your master copy of 
!System, you should then replace all your 
copies with a new copy of the master, one 
reason for keeping the number of copies to 
a minimum. 


This may seem a bit of a chore, but you 
won't need to do anything very often, and 
it will ensure that whichever copy of 
!System RISC OS sees first, it will always 
contain all the modules, and the latest 
versions, which any other application 
might need. Acorn has now come up with 
a utility called Sysmerge to help in 
updating !System, and this is increasingly 
likely to be included along with !System 
on applications discs by software houses 
(see Magpie review in this issue). Don’t be 
surprised if you get asked to re-insert a 
dise you last used half an hour or more 
ago - it could be that it had a copy of 
!System which RISC OS needs again. 


Well that doesn’t sound too bad after 
all, but how do I know which is the 
version number of any module? 


This is a little more complicated, 
though if a copy of !System is supplied on 
a dise with other applications, the 
documentation supplied with the disc, or 
help files on the disc, may give you this 
information. Otherwise switch on your 
Archimedes and proceed as follows. 


Insert a disc containing !System in a 
drive, and open its directory viewer by 
clicking on the disc drive icon on the icon 
bar. Now open the application directory 
for !System by double-clicking on the 
!System icon while holding down the Shift 
key. You will see !Boot, !Run and !Sprites 
files and another directory called Modules. 
Double-click on this to open it in turn. 
This will show the various modules 
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supplied with this copy of !System (the 
icon for a module has the letters RM top 
left, and the Archimedes ‘A’ bottom right). 


For each module in turn, double-click 
on its icon to load it into memory and then 
press F'12 giving the ‘” prompt at the foot 
of the screen. Type: 

Modules 
for a list of current modules. The one you 
have just loaded will be the last in the list 
(you may need to press Shift to scroll the 
display). Note that the name of the loaded 
module may well be different from its 
name in the directory viewer - for 
example, CLib appears as Shared 
CLibrary. Once you have identified the 
name of the new module, type in: 

Help <module name> 
as, for example: 

Help SharedCLibrary 
This will tell you the version number. 


It may be as well to keep a list of the 
version numbers so that you can check 
any newly acquired copy of !System 
against your current master version. 


Module Loaded 


Name 


SharedCLibrary 
FPEmulator 
ColourTrans 
ABCLibrary 
MessageTrans 
WindowUtils 


Latest 
Version 


3.66 
2.80 
0.60 
2.40 
0.06 
0.04 


CLib 
FPEmulator 


Colours 
ABCLib 


MsgTrans 
Wimputils 


Table 1. Latest System Resources 


If you follow the advice I have given 
here regarding !System, and keep all your 
discs well organised, you should find few 
problems with !System, and at least you 
are now prepared for why anything might 
go wrong. For reference, Table 1 gives a 
list of the !System resources of which we 
are aware and the latest version number 
of each. However, do not worry if you do 
not have the latest version of each module, 
or even all the modules listed. As I said 
before, any application needing a later 
version of a module or a non-standard 
module will normally include an 
appropriate copy of !System on the same 
disc (we do this with RISC User magazine 
discs where necessary). AU 
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CAD AND CAD / CAM SOFTWARE FOR THE ARCHIMEDES / A3000 


DESIGNER 
intro 


COST EFFECTIVE CAD 


DESIGNER INTRO is a powerful, yet easy to use 2D draughting 
system, based on its big brother DESIGNER (ARCHIMEDES). 
It is ideal for the production of high quality, accurate drawings, 
particularly when linked to a plotter. It makes light work of all the 
difficult areas of CAD, such as true blending arcs and tangents, 
simple deletion of part lines and arcs, automatic hatching, etc. 
Further features include ellipses, dimensioning, text, move, 
rotate, mirror image, alter size, pan, Zoom, etc. DESIGNER 
INTRO is an ideal introduction to CAD. In fact it will easily cope 
with all of most peoples draughting requirements. 


HB SALEORRETURNSOFTWARE |: 

Allorders marked “Sale or Return” will be supplied with an evalu- 
ation disc in addition to the main disc. If the software is returned in 
good condition, with the main disc still sealed, within 28 days, a full 
refund will be given. 

(Anyone in education is welcome to have an evaluation copy to 
review for 28 days, free of charge.) 


DESIGNER 


(ARCHIMEDES) 


MORE THAN JUST DRAUGHTING 


DESIGNER (ARCHIMEDES) offers a range of features that go 

well beyond just draughting. As well as a wide range of 

draughting options, it also provides some of the most 
comprehensive text (including font/symbol design), drawing 
manipulation and editing capabilities available. Additionally, a 

3D effects option allows 3D" extrusions in a variety of 
Projections, and wire frame solids of revolution, to be created for 
quick and simple visualisation. The graphic design capability of 
DESIGNER (ARCHIMEDES) easily encompasses such diverse 
activities as engineeering/architectural drawing, poster design, 
logo or sign design, dress design, cartography, etc. As well as 
supporting a vast range of plotters, DESIGNER (ARCHIMEDES) 4 
also has specific outputs forsuch devicesasthe ROLAND) «__ 
CAMM 1 vinyl cutter and the CAMM 2 engraver/miller (both 
available from TechSoft). _ 


e1 95 +VAT 


Overseas £215 OS bs es ar 


Ps — a a : 
HE Alloursoftware is packed with features fartoonumeroustolistin {jj OTHERPRODUCTS 


detail. Besides, no advertisement can show the most important 
feature - the simplicity of use that guarantees a short learning 
curve and rapid drawing / CNC file generation. 

Wi ORDERING = 
Cheque with order please, payable to TechSoft UK Ltd. 
Add VAT at 15% of total. (Official educational orders welcome.) EN 


Full information is detailed in our Product Guide available on request. 


Seu CAD/ CAM SPE 


CNC DESIGNER 


(ARCHIMEDES) 
DRAW IT MAKE IT! 


CNC DESIGNER (ARCHIMEDES) provides a means to realise 
the true potential of CNC lathes in education. It is an integrated 
CAD / CAM system comprised of the full DESIGNER 
(ARCHIMEDES) system plus a fully automatic post processor for 
CNC lathes. Simply draw a half profile of acomponent using the 
CAD routines, and a full CNC part program is automatically 
generated. Once generated the part program is transferred to 
the lathe’s own software for manufacture. Simple or complex 
components, including part arcs, screwthreads, boring, even 
ellipses can be easily designed and realised by students of all 
ages. In many cases transfer to BBC / Master software is 
possible. Available for a range of Boxford, Conect, Denford, and_-F 


Emco lathes. Kf 


CAD and CAD/CAM software for the BBC B/ Master series 
CAD related computer peripherals 

Plotters + accessories 

Digitisers 

Cutter plotters 

Engraving machine 


TechSoft UK Ltd. 


Old School Lane, Erryrys, MOLD, 
Clwyd CH7 4DA. 
Tel: (082 43) 318 Fax: (082 43) 564. 


by Lee Calcraft 


n part 5 of this series we looked at the 

way in which a task should respond to 
the Wimp Poll reason code with value 1 
(Redraw_Window_Request). To keep 
things simple, we made our test task 
respond to redraw requests by redrawing 
its whole window each time around. This 
is ok in a test program, but if your work 
area contains anything more than a trivial 
amount of text, you will slow down the 
Desktop to an unacceptable degree. This 
month we will take a closer look at the re- 
drawing process with a view to keeping it 
fast and efficient. To see how fast an 
application can respond to redraw 
requests, load a large text file into Edit, 
and then move a small window across it. 
You will see that redrawing is handled 
quite efficiently, and the progress of the 
window which you are dragging is not 
noticeably slowed - unless the text in Edit 
contains very long lines (or worst of all, no 
carriage returns at all). In this case, 
redraw is impossibly slow. 


It takes more than a little thought to 
ensure that your Wimp task contains fast 
and effective redraw routines. The 
simplest way to achieve great speed is to 
let the Wimp do all the work, and put all 
your text into icons. This sort of approach 
is only suitable for very specific 
applications however. It is impractical for 
large quantities of text, or text that is to 
be manipulated to any degree. In such 
cases you will have to resort to writing 
your own fast redraw routine. 


REDRAWING TEXT 

The principle involved in creating fast 
text redraw routines is simple: redraw 
only that part of the window which the 
Wimp nominates. In practice you can get 
away with redrawing complete lines of 
text (of up to 40 or even 80 characters in 
length), providing you only redraw those 
lines which fall within the nominated 
area. This makes life a bit easier, since we 
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Mastering the Wimp 
Part 16: Redraw Revisited 


only need to worry about the y co- 
ordinates of the redraw rectangle. 


Exactly what form the code in your 
redraw loop will take depends on how you 
have stored the text which is to appear in 
your window. Perhaps the simplest 
approach is to store it in some form of 
array. For example, a simple string array 
in which each line of the display is held in 
a separate element. This is easy to handle, 
and we will look at this case first, but 
before doing so I will mention a more 
flexible alternative. 


If you have a sizeable quantity of text 
in your work area, and especially if you 
are to manipulate it in any way, then long 
string arrays are out, since they provide 
no flexibility at all. The only viable 
alternative is to store the text directly in 
memory, perhaps using character 13 as an 
end of line marker, or perhaps without 
any such markers. In either case, you 
must hold an array of pointers to the start 
of each line. This is essential, because 
there is no time to work through the 
whole file to discover where each line 
begins once a redraw request has been 
received. The redraw process is extremely 
time critical, and if it is slowed down in 
any way the Desktop will become very 
sluggish indeed. 


By holding an array of pointers, you 
can immediately find the start of the line 
of text to be displayed, given the number 
of the line, counting from the start of the 
text file. We will give an example of this 
technique in due course, but we will start 
with the slightly simpler case of text held 
in a string array. 


REDRAWING TEXT HELD IN 
AN ARRAY 


The best way to see how this is 
achieved is to look at an example. The 
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procedure PROCredraw in listing 1 
implements a fast redrawing routine, and 
one whose speed is independent of the 
amount of text held. If you want to try it 
out, you can call it by placing the following 
line in the Wimp Poll 
loop of an application 
program: 
WHEN 1:PROCredraw 

The procedure is 


On entry 
On exit 


As you can see from the program there 
are two nested WHILE loops. The outer 
one cycles round once for each rectangle 
which the Wimp requests to be redrawn, 
while the inner one prints just those lines 

which feature in 


R1=pointer to block the nominated 
RO=0 forno more rectangles to | rectangle. This is 
redraw achieved by 


obtaining values for 


quite self contained, 
and assumes that the 
text to be redrawn is 
held in the array 
display$(), and that 


Ri+0 
Ri+4 
R1+8 
R1+12 
R1+16 


window handle 

visible area min x coord 
visible area min y coord 
visible area max x coord 
visible area max y coord 


top% and base%. 
These are _ the 
upper and lower 
bounds of the 
region that the 


R1+20 
R1+24 
R1+28 
R1+32 
R14+36 
R1+40 


there are currently 
dispsize% valid lines. 


If you want to test 
the procedure out in a 
controlled way, you 
could use it with the 
very short Wimp 
program developed 
last month to illustrate the use of 
templates. In this case, you will need to 
use the Template editor to alter the main 
window as follows: 

1. Unset the auto-redraw flag 

2. Remove any icons from the window 

3. Extend the vertical work area extent 

to at least 2000 OS units 
Finally you will need to include 
PROCmakearray from listing 1. This 
simply sets up a suitable text array. This 
procedure should be called once at the 
start of the program. 


HOW IT WORKS 

PROCredraw is really a pretty 
straightforward redraw loop, designed to 
display the block of text indented by 16 OS 
units from the left hand side of the window. 
First of all we obtain the co-ordinates (in 
OS units) of the the work area origin by 
subtracting the position of the x and y 
scroll bars from the co-ordinates of the top 
left-hand corner of the visible area. All this 
information is returned by the call to SYS 
“Wimp_RedrawWindow”. Table 1 gives the 
parameters, but see also the PRM page 
1204 for further details. 


scroll x offset rel to wae origin 
scroll y offset rel to wae origin 
curr graphics window min x coord 
curr graphics window min y coord 
curr graphics window max x coord 
curr graphics window max y coord 


Table 1. Parameter block returned with 
SYS “Wimp_RedrawWindow” and SYS 
“Wimp_GetRectangle”. 


Wimp has 
requested to be 
redrawn, and are 
measured in OS 
units relative to the 
work area origin. 
To determine which 
lines of the array to 
print we just divide 
these values by 32 (since each line of text 
is 32 OS units in height regardless of 
which mode is used in the Desktop). At 
the bottom end (base%) we add a small 
measure to counteract the effect of 
rounding down (since integer division is 
used), and there you have it. 


The case where the text to be written 
is held in a block of memory is very 
similar. Suppose that the array array%() 
contained a set of pointers to the start of 


- each line of text in such a way that 


array%(0) contained the address of the 
start of the first line of text, and so on. All 
we would need to do to alter PROCredraw 
appropriately is to replace the PRINT 
statement by: 
PRINT Sarray% (i%) 

This assumes that each line of text is 
terminated by a carriage return character 
in memory. 


Incidentally, to see just how slowly the 
redraw routine operates when the whole 
text file is redrawn in response to every 
redraw request, alter the assignments of 
top% and base% in the outer WHILE loop 
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topt=1 

baset=dispsize? 
If you now re-run the program you will see 
that any attempt to drag an object across 
the task’s window is impossibly slow - and 
this is only with a very short text file. 


You can test the speed of redraw by dragging a 
small window across the window of your task. 


REDRAWING GRAPHICS 


When redrawing graphics objects, two 
different approaches can be adopted. 
Either you can use a technique similar to 
that discussed above for use with text, 
where you determine the co-ordinates of 
the area to be redrawn, and redraw just 
that area; or you can take a short-cut and 
use sprites. In practice, the first of these 
two methods may not be feasible in all 
situations. It may not be possible to draw 
the right hand part of a graphic without 
having drawn the left part first - or at 
least without having calculated where 
the left hand part would fall. Also there 
may be no easy way to know exactly 
which part of your drawing code to 
activate to draw a particular segment of 
a drawing. 


For example, suppose the graphic is a 
map of the U.K., and that it is drawn from 
an array of points. There is no obvious 
way to get from the bounding rectangle 
returned by the Wimp with a redraw 
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request to co-ordinates of the points 
required to redraw the nominated area. In 
such cases, the fastest redraw will often 
be obtained by initially drawing the 
graphic to a sprite, and then redrawing 
this in full when redraw requests are 
made. Of course large sprites can take up 
a great deal of memory, but this method 
can be very effective. If you are interested 
in pursuing it you are referred to the 
Desktop Graph Plotter described in RISC 
User Volume 4 Issue 1 page 15, where this 
technique is used to good effect. 


Next month we will be finishing off the 
series with a look at the way in which 
applications can interface with the RISC 
OS printer drivers. 


1000 DEFPROCredraw 

1010 SYS "Wimp RedrawWindow",, blocks TO 
moret 

1020 x0%=16+block$ ! 4-block$!20 

1030 y0%=-16+block$!16-block%$!24 

1040 WHILE more’ 


1050 =topt=(y0%-block$!40) DIV 32 
1060 IF top$<0 THEN top%=0 

1070 =baset=(47+y0%-block$!32) DIV 32 
1080 it=topt 

1090 WHILE it<dispsize$ AND i%<=base$ 
1100 MOVE x0$, yO%- (i3<<5) 

1110 PRINT display$ (i$) 

1120 it+=1 

1130 ENDWHILE 

1140 SYS "Wimp GetRectangle", ,block$ 
TO more$ 

1150 ENDWHILE 

1160 ENDPROC 

1170 : 


1180 DEFPROCmakearray 

1190 DIM display$ (200) :B%=1 
1200 A$=STRING$ (8,"RISC User ") 
1210 FOR At=0 TO 200 


1220 display$(A%)=MID$ (AS, B%, 60) 

1230 B%=B% MOD 10 +1 

1240 NEXT 

1250 dispsizeb=A$+1 

1260 ENDPROC RU 
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The ultimate rally 
driving simulator 


Pirate Software 
CON fa Ne Ss PES 


for the Archi- course notes - 
medes, incorpor- you will even be 
ating 4 billion able to win prizes 
fractal generated by entering the 


ah 4 
Soyer 


landscapes, 3D 
solid polygon 


regular prize ral- 
lies! 


Proudly Presents 3 


Fast ‘n’ Loose 


Only £17.50 including VAT and Post. 


For free playable demo. version, send a blank disk and a SAE. 
Available only by mall order from Pirate Sofware, P.O. Box B126, Hudderefleld, West Yorkshire. HD1 1YH 


“FIRST 
ADVANCED STATISTICAL SYSTEM 


For Acorn Archimedes; BBC Models B, B+ and Master; “Industry Standard” machines 
A powerful and practical tool for Research, Industry, Business, and Teaching 


Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing values and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 
Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, influential points etc. Automatic warnings. 

ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 

One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 


Price £120-£180 (machine and version dependent). Special RISC USER discount available. 
There's far too much to describe here. Get full information now from: 
Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L64 1SD Tel. 051 327 4268 


L 


Guild of Thieves 
Herewith the Clues 
Holed Out 

Holed Out Designer 


Interdictor I 
Jet Fighter 
Mad Professor Mariarti 


Repton 3 

Rotor 

Sporting Triangles 
Superior Golf 
Talisman 

The Olympics 
The Pawn 

The Wimp Game 
Thundermonk 
Trivial Pursuit 
ULM. 

White Magic I 
World Cl Leader Board 
Zarch 


INIFA 


Serlouas 

1st Word Plus I 

8 bit Sampler & Midi 
8 bit Sound Sampler 
Acorn DTP 


Autosketch Version 2 
Cambridge Pascal 
Datavision 
Deltabase 

Desktop Office 

Disc Tree Version 2 
Easiword 

Euclid 

Film Maker 
Financial Accountant 
Flexifile 

Fortran 77 release 2 
Gamma Plot 
Genesis 

Gerber Plot 
GraphBox Version 2 
Hearsay 

Home Accounts 
Hotlink Presenter 
Impression II 
Impression Junior 
Instigator 

Iso Pascal Release 2 
Knowledge Organiser 
Lisp 

Logistix 

Mailshot 

Mogul 

Multistore VII 
Newhall Font Pack 
Nominal Ledger 
Ovation 

PC Access 


BEST SOFTWARE 
BEST PRICES 


£79.95 
£179.95 


PC Emulator £99.95 
Pipedream 3 £144.95 
Presentation System £69.95 
Presenter IT £39.95 
Pro Artisan £84.95 
Prolog £199.95 
Purchase er £57.95 
Realtime Solids Modler £164.95 
Render Bender £70.95 
Reporter £34.95 
Rhapsody £44.95 
Rise Basic Compiler £129.95 
Rise Forth £129.95 
Progs. Ref. Manual £79.95 
Robo Logo £86.95 
Sales Ledger £57.95 
Scan LightJunior Arc £199.95 
Scan Light Junior A300) £199.95 
Scan light Senior £429.95 
Schema £109.95 
School Administrator £69.95 
Sigma Sheet £59.95 
Software Dev. Toolbox £199.95 
SolidCad £129.95 
SolidsRender £129.95 
Solidtools £319.95 
Spelimaster £29.95 
Stock Management £57.95 
System Delta Plus £69.95 
Tempest DIP £109.95 
Tracker £44.95 


Our software price list offers all the 
latest Archimedes software at a 
discount of around 10% or more. All 
listed prices include VAT and P&P. 
Goods are normally despatched first 
dass within 48 hours. - subject to 


availability- 


ARCAYNIA SOFTWARE SUPPLIES, 
PO Box 1927, 
Satton Coldfield, 

B74 3Q7Z. 


Public Domain Software 


We are still able to offer the best 
Archimedes PD selection, with a 
fast efficient service for only £1.50 


per disc. Send a £1 cheque or coin 
for Arcaynia Demo/Catalogue Disc 
4, Or send a SAE for a full list of all 
our Commercial and PD software. 
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by Mike Hunter 


Implementing this facility requires a data 
file which is supplied only on this month’s 
magazine disc. 


1st Word Plus uses the application 
lstChars for the entry of non-keyboard 
characters into the text. This displays the 
‘printable’ characters of the current 
alphabet in a window. Clicking with the 
mouse on a character in this window 
enters that character into the text at the 
current caret position. Any alphabet may 
be selected, and will be displayed in the 
lstChars window. 


Unfortunately, the printer drivers 
supplied with 1st Word Plus do not 
match the characters in any of the 
RISC OS alphabets. Thus, even with 
the default (UK) alphabet, there are 
characters which can be inserted into a 
1st Word Plus document on the screen, 
but which will not print on paper. 


In principle, some printers which 
accept downloaded’ character 
definitions could be made to print all 
the ‘printable’ characters correctly. 
However, some printers have very 
limited download capabilities (e.g. 
Epson LX), or downloading requires 
setting a DIP-switch or sacrificing the 
print buffer (e.g. Epson LQ). In any 
case, Acorn does not provide 
downloadable fonts, even for its 
default alphabet. 


This article explains how you can use a 
new application [BMchars to define an 
alphabet, with some useful characters 
(e.g. Greek and other characters 
commonly used in scientific writing) not 
present in the default Archimedes 
alphabet, all of which may be printed on a 
printer which has the standard IBM 
character set (true of many printers on the 
market). 


The IBMchars alphabet uses characters 
&20-&7E from the Archimedes default 


ihe corcesuratios ist 
tomatica 


(UK) alphabet, but overwrites characters 
&A0-&FE with some characters from the 
standard IBM _ alphabet, using 
VDU23,n,d1..d8 sequences stored on disc 
as a file called Alpha_IBM. Characters 
&80-&9F are not displayed by 1stChars, 
and in any case some of these are needed 
by RISC OS for window icons, so the IBM 
characters normally coded in this range 
instead replace some of the less useful 
graphic characters at &BO-&CF. 
Characters &AO-&AF and &E0-&FE are 
standard IBM printer characters, while 
&DO-&DF provide some of the printable 
IBM graphics characters. 
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character set 


To print the alphabet defined by 
IBMchars, a suitable printer driver must 
be installed in 1st Word Plus. Many Epson 
(and compatible) printers will print the 
IBM character set while remaining in 
Epson mode, on a software command, 
without requiring DIP-switches to be 
changed. The printer driver I use does this 
for my LQ-compatible Star LC24-10. 
However, very few alterations should be 
needed for other Epson/compatible printers, 
or for printers in IBM emulation mode. 


IMPLEMENTING IBMchars 


To use IBMchars you will need to 
create a modified version of the 1st Word 
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Print <Obey$Dir>.Alpha_IBM 
Copy adfs::1WP_Prog.$.!lstWord+.<new_driver> 


Plus 1stChars application and save it with 
this new name. Both 1stWord+ and 
1stChars are supplied by Acorn on the 1st 
Word Plus Program Disc, and it is a good 
idea to install IBMchars on the same disc, 
or even better on a backup of the original 
which you use as your working copy. 


First of all you will need a new 
application directory to be called 
'IBMchars. Such a directory is supplied on 
this month’s magazine disc ready for use. 


The file Alpha_IBM (supplied on the 
magazine disc) in IBMchars contains the 
definitions for the IBM character set. This 
application also contains an alternative 
sprite to be used as the application’s icon - 
you could design your own if you wish. 


You will also need to copy the 
!'RunImage and Templates files from 
within 1stChars to the new application 
IBMchars. In addition you will need to 
incorporate a !Run file in your new 
application. Read the !Run file from 
1stChars into Edit, add the following two 
lines following the initial comment line, 
and then save this version as !Run in the 
!T1BMchars directory: 


adfs::1WP_Prog.$.!1lstWord+.lwp print F~C 


Note that <new_driver> is the modified 
printer driver for IBM characters (see 
below). 


To be able to revert to the normal 
character set (using 1stChars) it is helpful 
to modify similarly the !Run file in the 
!1stChars directory to include: 


Copy adfs::1WP_Prog.$.!1stWord+.<normal_driver> 


adfs::1WP_Prog.$.!1stWord+.lwp print F~C 


where <normal_driver> is your normal 
printer driver. 


1st Word Plus also provides the source 
for creating your own printer drivers. You 
may need to create a modified printer 
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driver for use with your own printer which 
will select the IBM character set. The 
magazine disc contains source and 
assembled printer drivers for the Star 
LC10 and LC24 printers (in directories 
Source and Config within IBMchars). 


The sources supplied may be used for 
guidance if you need to create your own 
printer driver. The principal requirement 
is to specify the translation table between 
the character codes used by the Arc and 
those used by the standard IBM character 
set. Use the 1st Word Plus utility 
1stConyrt to convert the source for any 
printer driver of your own into the printer 
driver itself. 


Assembled printer drivers should be 
saved in the !1stWord+ directory. This 
applies if you use either of the printer 
drivers from the magazine disc. 


Once IBMchars has been set up in this 
way, double-clicking on the IBMchars 
application will open a window showing 
the modified (IBM) character set (see 
illustration) and select the modified 
printer driver, while double-clicking on 
the 1stChars application icon will restore 
(or select) the standard character set and 
the default printer driver. 


PROBLEMS 
Problems - character &AO is assumed 
by 1st Word Plus to be a hard (non-break 
or fixed) space, and is shown as such in 
the 1lstChars character set window, 
regardless of how it is actually defined. 
IBMchars codes &AO as a (a acute). The 
character &FF is shown as y (y umlaut) in 
the IstChars standard alphabet, but 
cannot be inserted into a document 
(IBMchars treats &FF as non- 
printable). The 1stChars character set 
is displayed in a non-standard order 
intended to make its layout more 
logical. With the IBMchars alphabet, the 
result is less satisfactory. 


Next month we hope to return to the topic 
of letter writing using DTP with more 
advice on letterheads. RU 
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Archimedes Memory Upgrades 


4Mb of RAM for your 
A310 or A305 is now only 
£399 inc. VAT/fitting 


This includes a free MEMC1a worth 
nearly £80, while stocks last. 


* ARMS compatible. 
* MEMC1a upgrade supplied. 


* Fully compatible with upgrades 
such as hard discs and 
backplanes. 


* Price includes fitting and carriage 
both ways. 


A3000 RAM 

2Mb (total), £69. Upgradable to 4Mb. 
4Mb (total), £220. 
Bare board, £29. 
A data sheet is available for these upgrades. 
This explains the type of chips needed for 
the "bare board", which has high quality 
sockets for the RAM chips. Only 8 devices 

are required. 


400/1 series RAM 


1Mb, £58. 2Mb, £100. 3Mb, £130 


Impression 2 

This is still only £145 inc. VAT when bought 
at the same time as any memory upgrade. 
Combination deals 

We can suppy and fit ARM3 upgrades as well 
as a range of hard discs. Call us to discuss 
your requirements. 


Why is it so inexpensive? 

Quite simply, by design. By using as few 
components as possible, the size of the 
board is reduced and production costs are 
lower. We implement 4Mb using just 11 
chips, whereas some other expansions 
need over 50! The use of fewer 
components results in lower power 
consumption, and greater reliability. 


8Mb potential! 

The small size of the board even allows an 
8Mb upgrade to be fitted - the A380? This 
would be impossible with other RAM 
expansions. Our information pack gives 
further details. 


For £399 inc. VAT you get; 
Courier collection of your machine. 
The improved memory controller, 
MEMCla. This upgrade alone has an 
RRP of £79.35, and boosts the speed of 
the machine by approximately 10%. 
Fitting and testing of the 4Mb memory 
upgrade. 

Courier return of your computer. 

12 month's warranty. 


Fitting time 

We use an overnight courier service both 
ways, and can therefore offer a turnaround 
of typically 2 or 3 days. 


Further details 

An information pack is available which 
gives further details on this upgrade. 
Write or phone for a free copy. 


Ordering details. All prices include VAT. 
Payment by Access, Visa or cheque with order, 
Official and overseas orders welcome. 


wa €=IFEL, 36 Upland Drive, Derriford, Plymouth, PL6 6BD. (0752) 847286 | 
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Bicubic Parametric What? —— 
A first look at Bezier Curves (Part 2) 


Derek Marriott concludes his discussion of Bezier curves by looking at 
their application to three-dimensional objects. 


THE THIRD DIMENSION 


One of the most popular methods for 
describing a surface in computer graphics 
is the Bezier Patch, developed in the 1960s 
by Pierre Bezier for use in the design of 
car body panels for Renault. His computer 
aided design (CAD) package was in use by 
1972, and was used for the design of 
Renault bodies throughout the ‘70s. 


We can build on what we know for 
curves to produce a formula for patches: 
3 3 


P(u, v) = LD Pi B;, (w)B;, av) 
i=0 j=0 

The blending function is the same as was 
used before. Note that we now have two 
parameters, u and v, and two cubic 
equations, so we have a bicubic 
parametric patch. This is remarkably 
similar to the formula for the curve, 
except that we have two variables u and v 
which vary between 0 and 1. There are 
now 16 control points arranged in a 4x4 
matrix, and these relate to the patch as 
shown in figure 4. The corner points, Po, 
Po, Pog and P33, are, like the end points 
of the curve, on the surface of the patch, 
the other points exert a pull on the surface 
to produce the required shape. 


Figure 4. A control Polyhedron 


This can be programmed as an 
extension of that used to draw a curve, 
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except that the output is now in three 
dimensions so some translation of the 
output is also required to produce a two- 
dimensional screen image (such a 
program is included on the magazine disc 
as Bezier4. Since matters are getting more 
interesting, the program contains a little 
extra code to allow several patches to be 
drawn). 


As before, such a program is very slow, 
and thus impractical, so we shall devise a 
subdivision algorithm, which is also where 
things start to get complicated. 


Figure 5. Patch subdivision 


Draw out the control points of the 
patch on a flat surface, to make life easy, 
as in figure 5a. Using the same technique 
as for curves, we can split the rows of 
control points, in u, into two, to produce, 
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notionally, two long, thin patches as shown 
in figure 5b. Now we take each of these 
thin patches and split them along v, or 
along the columns of control points, and 
produce two square patches for each long 
thin patch (figure 5c). So one large patch is 
divided into four small ones. To draw the 
patch all one does is to draw the square 
connecting the corner control points. 


The program which does this (listing 5) 
is really very simple considering the 
output from it. It is not lightning fast, 
but it is in Basic, and it does show what 
can be done. The version on the 
magazine disc includes the (much 
longer) data for that universal test 
object, a sphere. 


Again, Flatness can be associated 
with a patch, but this produces tears in 
the patch (figure 6) as not all of the 
patches are being divided equally. This 
is overcome by post-processing the 
image for the holes (which appear as 
small black regions on objects which 
have been shaded). A second program 
looks at the screen image finally 
produced, looking for the holes and 
filling them in. Although this sounds like 
cheating it works. I shall leave this as an 
exercise for the reader. 


Figure 6. Tears formed by non-uniform 
subdivision 


A further version of listing 5 (the 
program Bezier6) is included on the 
magazine disc. This allows a choice of 
object from data definitions kept in a 
separate file (created with Edit). The 
model of the Utah teapot (see figure 7), 


developed by M. Newell in 1975, is an 
object which has become a benchmark in 
computer graphics. Its curves and holes 
provide the ideal way to test shading 
algorithms to the limit, and it is also 
infinitely more interesting than spheres. 
It consists of 306 co-ordinates (3D) 
composed into 32 patches, arranged in 4 
groups - the body, lid, spout and handle. 
It’s just a shame the lid doesn’t fit 
properly (you can alter the data easily to 
make it fit)! 


Figure 7. The Utah teapot 


So there you have a short trip through 
the world of Bezier curves and patches. 
The routines presented are crying out for a 
machine code implementation as they are 
so simple. I have used real numbers for the 
calculations as the data for the Utah 
teapot comes as such, but the routines 
work equally well with integers. You may 
like to add hidden surface removal to a 
patch, i.e. divide only if the patch is visible, 
or shading which does have some problems 
in that triangle-shaped patches have two 
corner control points the same which gives 
a surface normal of zero (see the sphere or 
teapot lid). 


So where can you go from here? A 
starting point would be to alter listing 5 to 
allow for non-uniform subdivision and 
investigate the problem of tears, but that 
is just an idea. Play with the objects and 
find out why most 3D packages, to date, 
use polygon mesh models. 
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Watt, Alan (1989); Fundamentals Of 
Three-Dimensional Computer Graphics 
(pp.115-139). 


Burger, P., Gillies D. (1989); Interactive 
Computer Graphics - Functional, 
Procedural and Device-Level Methods 
(pp.241-283). 


My thanks to Ste Maddock, University of 
Sheffield, for the ideas. 


Listing 5 
10 REM >Bezier5 


20 REM Recursive Subdivision 

30 REM Version Al.0 

40 REM Author Derek Marriott 

50 REM RISC User March 1991 

60 REM Program Subject to copyright 


80 MODE 12 

90 GCOL 128;CLG 

100 S=2 :REM Scale value for image 

110 PROCsetupcontrol 

120 dist%=30000:ORIGIN 640,512 

130 PROCinitvtrans (250, 60, 60) 

140 DIM patch (3,3,3) 

150 Number=3 :REM Number of divisions 

160 FOR Counti=1 TO Patches$ 

170 FOR ui=0 TO 3 

180 FOR vt=0 TO 3 

190 FOR planes=1 TO 3 

200 patch (ut, vt, plane%)=V(P (Count 
,u%,v4),plane§) 


210 NEXT 
220 NEXT 
230 NEXT 


240 PROCdrawBez (patch (), Number) 

250 NEXT 

260 END 

270 : 

280 DEF PROCdrawBez (P(),N) 

290 LOCAL Topleft (), Topright (),Botleft 
(),Botright () 

300 DIM Topleft (3,3,3),Topright (3, 3, 3) 
,Botleft (3,3,3),Botright (3,3, 3) 

310 IF N=0 THEN 

320 PROCdrawpatch (P (}) 

330 ELSE 

340 PROCsplitpatch(P(),Topleft (), Topr 
ight (), Botleft () ,Botright ()) 
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350 PROCdrawBez(Topleft(), N-1) 

360 PROCdrawBez (Botleft(), N-1) 

370 PROCdrawBez (Topright () ,N-1) 

380 PROCdrawBez (Botright (),N-1) 

390 ENDIF 

400 ENDPROC 

410: 

420 DEF PROCsplitpatch (P(),RETURN Topl 
eft (),RETURN Topright (),RETURN Botleft () 
,RETURN Botright ()) 

430 REM patches (3,3) 

440 LOCAL BigPatch(),split%, V3,U%,plan 
e3, left (), right () 

450 DIM BigPatch (6, 6,3), left (3,3,3),ri 
ght (3,3,3):REM Holds total grid 

460 PROCsplitInU (P(),BigPatch ()) 

470 FOR split%=0 TO 3 

480 FOR Vi=0 TO 3 

490 FOR planet=1 TO 3 

500 left (splitt,V%,planet) =BigPatc 
h(split’, V3, plane$) 

510 right (spliti, Vi, plane$) =BigPatc 
h(3+splitt, V3, plane’) 

520 NEXT 

530 NEXT 

540 NEXT 

550 PROCsplitInV (left (),BigPatch ()) 

560 FOR split%=0 TO 3 

570 FOR U%=0 TO 3 

580 FOR planet=1 TO 3 

590 Topleft (U%, splitt, plane’) =BigPa 
tch(U%, split$, plane$) 

600 Botleft (U%, split, plane) =BigPa 
tch (0%, 3+split%, planet) 

610 NEXT 

620 NEXT 

630 NEXT 

640 PROCsplitInV (right (),BigPatch ()) 

650 FOR split%=0 TO 3 

660 FOR U%=0 TO 3 

670 FOR plane%=1 TO 3 

680 Topright (U%, split’, plane’) =BigP 
atch (0%, split%, plane$) 

690 Botright (U%, splitt, plane$) =BigP 
atch (U%, 3+split3, plane’) 

700 NEXT 

710 NEXT 

720 NEXT 

730 ENDPROC 

740 : 

750 DEF PROCsplitInU(patch(),RETURN Bi 
gPatch ()) 
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760 REM A Patch into a 7,7 matrix 

770 REM u >,v * 

780 LOCAL V%,plane%,C 

790 FOR V%=0 TO 3 

800 FOR plane%=1 TO 3 

810 C=(patch(1,V%,plane%) + patch(2, 
V%, plane$) ) /2 

820 BigPatch(0,V%t,plane%) = patch(0, 
V3, planet) 

830 BigPatch(1,V%,planet) = (patch(0 
,V%,plane$) + patch (1,V%,plane$) ) /2 

840 BigPatch(2,V%,planet) = (BigPatc 
h(1,V%,planet) + C)/2 

850 BigPatch(6,V%,plane%) = patch(3, 
V%, plane$) 

860  BigPatch(5,V%,plane$) = (patch(2 
,V3,plane%) + patch (3,V%,plane$) ) /2 

870 BigPatch(4,V%,plane$) = (BigPatc 
h(5,V%,plane%)+ C)/2 

880  BigPatch(3,V%,planet) = (BigPatc 
h(2,V%3,planet) + BigPatch (4,V%,plane3) )/ 
2 

890 NEXT 

900 NEXT 

910 ENDPROC 

920 : 

930 DEF PROCsplitInV(patch(),RETURN Bi 
gPatch()) 

940 REM A Patch into a 7,7 matrix 

950 REM u >,v * 

960 LOCAL U%,planet,C 

970 FOR U%=0 TO 3 

980 FOR plane$=1 TO 3 

990 C= (patch(U%,1,plane%) + patch/( 
U%,2,plane$) ) /2 


1000 BigPatch(U%,0,plane%) = patch (U% 
,0,plane%) 
1010 BigPatch(U%,1,plane%) = (patch(U 


%,0,planet) + patch (U%,1,plane%))/2 
1020 BigPatch(U%,2,planet) = (BigPatc 
h(U%,1,plane%) + C)/2 


1030 BigPatch(U%,6,plane3) = patch (U% 
,3,plane$) 
1040 BigPatch(U%,5,planes) = (patch (U 


%,2,plane%) + patch (U%,3,plane%) )/2 
1050 BigPatch(U%3,4,plane%) = (BigPatc 
h(U3,5,plane%) + C)/2 


1060 BigPatch(U%,3,plane%) = (BigPatc 
h(U%,2,plane$) + BigPatch(U%,4,plane%))/ 
2 

1070 NEXT 

1080 NEXT 


1090 
1100 
1110 
1120 
1130 
13)) 
1140 
13)) 
1150 
/3)) 
1160 
13)) 
1170 
13)) 
1180 


ENDPROC 


DEF PROCdrawpatch (P ()) 

REM P has vertices in it 
PROCmove3D (P (0,0,1),P(0,0,2),P(0,0 
PROCdraw3D (P (3,0,1),P(3,0,2),P (3,0 
PROCdraw3D (P (3, 3,1),P(3,3,2),2(3,3 
PROCdraw3D (P (0,3,1),P(0,3,2),P(0,3 
PROCdraw3D (P (0,0,1),P(0,0,2),P(0,0 


ENDPROC 


1190 : 


1200 
1210 
1220 
1230 


DEF PROCmove3D (x, y, Zz) 

REM moves absolute line in 3D 
PROCpoint (x,y,z) :MOVE xs,ys 
ENDPROC 


1240 : 


1250 
1260 
1270 
1280 


DEF PROCdraw3D (x,y, 2) 

REM draws absolute line in 3D 
PROCpoint (x,y,z) :DRAW xs, ys 
ENDPROC 


1290 : 


1300 
1310 
1320 
1330 


DEF PROCpoint (x,y,z) 

REM xs,ys contain 2D screen coord 
PROCvtrans (x,y, Z) 

ENDPROC 


1340 : 


1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 


DEF PROCinitvtrans (rho, theta, phi) 
REM Initiates viewing matrix 
LOCAL st,ct,sp,cp 
st=SIN (RAD (theta) } 
ct=COS (RAD (theta) ) 

sp=SIN (RAD (phi) ) :cp=COS (RAD (phi) ) 
va=-st:vb=ct :ve=-ct*cp:vf=-st*cp 
vg=sp:vi=-ct*sp:vj=-st*sp 
vk=-cp:vl=rho 

ENDPROC 


1450 : 


1460 
1470 
1480 
1490 
1500 
1510 
1520 


DEF PROCvtrans (x,y, 2Z) 

REM Perform transformation 
xe=va*xt+vb*y 
ye=ve*xtvitytvg*z 
ze=vi*xtvj}*ytvk*ztvl 
PROCperspect (xe, ye, ze) 
ENDPROC 


1530 : 


1540 
1550 


DEF PROCperspect (xe, ye, ze) 
xs=distt*xe/ze:ys=disti*ye/ze 
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1560 ENDPROC 1770 REM Add more if you so desire 
1570 : 1780 REM 16 vertices for one patch 
1580 DEF PROCsetupcontrol 1790 DATA 16, 1 
1590 LOCAL N%,M%,Vert%,Count? 1800 : 
1600 READ Vertices$,Patches$ 1810 REM Vertex No, x, y, z 
1610 DIM V(Vertices%,3) ,P (Patches$, 3, 3) 1820 DATA 1, 0.0, 0.0, 0.0 
1830 DATA 2, 0.0, 0.8, 0.0 
1620 FOR Na=1 TO Vertices’ 1840 DATA 3, 0.0, 1.6, 0.4 
1630 READ Vert%,V(N%,1),V(N%,2),V(N3,3 1850 DATA 4, 0.0, 2.4, 0.0 
) 1860 DATA 5, 0.8, 0.0, 0.0 
1640 V(N%,1)=V(N3,1)*S:V(N%,2)=V(N%, 2) 1870 DATA 6, 0.8, 0.8, 0.0 
*S:V(N3,3)=V(N%, 3) *S 1880 DATA 7, 0.8, 1.6, 0.0 
1650 IF Vert%<>Nt THEN PRINT"Error in 1890 DATA 8, 0.8, 2.4, 0.0 
table": END 1900 DATA 9, 1.6, 0.0, 1.0 
1660 NEXT 1910 DATA 10, 1.6, 0.8, 0.0 
1670 FOR Count%=1 TO Patches$ 1920 DATA 11, 1.6, 1.6, 0.0 
1680 FOR N3=0 TO 3 1930 DATA 12, 1.6, 2.4, 0.0 
1690 FOR Mt=0 TO 3 1940 DATA 13, 2.4, 0.0, 0.0 
1700 READ P (Count%,N%,M3) 1950 DATA 14, 2.4, 0.8, -0.2 
1710 NEXT 1960 DATA 15, 2.4, 1.6, 0.0 
1720 NEXT 1970 DATA 16, 2.4, 2.4, 0.0 
1730 NEXT 1980 : 
1740 ENDPROC 1990 REM Define how patch is made up 
1750 : 2000 DATA 1,2,3,4,5,6,7,8,9,10,11,12,13 
1760 REM Define a single patch ,14,15,16 RU 
w\/- WIG The Archimedes Voice Generator 
OTEACHING MUSIC OVOICES FOR MUSIC 
OTEACHING SOUND OSOUND FOR GAMES / DEMOS 


Create an unlimited range of different sounds & instruments 
by means of harmonics, interpolation, enveloping, and more! 


“AVG provides an extensive range of tools with which tomanipulate sound ... After 
extensive use, I can confirm that this is a small price to pay for such a detailed 
piece of software’ ACORN USER (Feb '90) 


“AVG is an excellent ard and does its best to stike a balance between 
complexity and cincl. vemscitty A superb tool for anyone wishing to experiment with 
sound samples or apants and envelope generation” 


MICRO USER (May '90) 


“AVG provides a tremendous wealth of facilities for VOICE creation... I have 
ee ee which is so comprehensive and has so much to offer in 
its fie! 


enim: MJD SOFTWARE 
att rorjust FQ OF anc. rary 13 BURNHAM WAY 
Available direct, or from AVP or BEEBUG (order code 5459). | LONDON W13 9YE_ 
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PIPEDREAM 3 


ean: adfs::a44@wini.$. 


calculations within your databases. 


easier. 


Major features include: 


1 Car Lovers Annual Report on Company Fleet 
2 Value Value 9 
3 year ago row imc Cpety  Cyls Reg. 
4) Poesche Carrera RSL £50000 £15000 MOO® 170 6 RS 27 
5 AC Cobea 289 MA II £90,000 £150,000 166.7% 4.700 & 289 COB 
6 Jaguar D type £375,000 £95000€0 253.15 1800 6 Di 
7 Ferrari 250 SWB £500,000 £1,100.000 220.0% 3,300 12 SWB 2% 
§ , Fewrari 8 GTB 035,000 £60,000 171.4% 3,000 & GTB wR 
‘ Comment Fleet values 

12 As you can see from tt 

ii the graph on the right — jooof CD Value year apo 

14 hand side, the Car Value now 

15 Lovers investment in “+ Apprechalon 

16 superb classic carshas ¥ 700 

1? perfoemed outstand- 

18 ingly, outstripping 

19 most conventional * 

i forms ofinvestment. =» 

be wor 

i The outlook remains =? 

23° wsy, = with ~—s more W i | = °| 

24° investment funds 0 

25. ilowing onto. the Poeehe RS AC Cabs laguer  Kerraey SW Herts Mia 

i market, 


PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 


Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3. Itis fully multi-tasking and multi-windowing, so you can work on many documents at onceand instantly 
move information between them. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 


Power, flexibility, speed, ease of use. PipeDream 3. Breaking down the barriers. 
For a free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and 1Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT. 


many documents loaded at once 
intuitive RISC OS user interface 
displaying and printing 

of pictures within text 

built-in 93,003 word 


automatic loading of VIEW, 
ViewSheet, Lotus, First Word 
Plus, Tab and CSV files 
automatic saving of VIEW, 
Lotus, Acorn DTP format, Tab 


‘bis 4 free brochure, complete and retum this coupon 
PipeDream 3) View Professional ( 
[Name 


spelling checker and CSV files 
file compatibility with 

PC & 288 PipeDream and 
BBC View Professional 
background recalculation 
keystroke compatibility 
with Z88 & PC PipeDream 
288 filing system 


modelling 
slot protection 


All trademarks achnowled ged The chart in the screen shown abooe was produced by 
back into 


multi-field sorting 

use of all available fonts 
62 spreadsheet functions 
external references for 3-D 


macro file recorder 


sending numbers 

PipeDream 3 
Colton Software, Broadway House, 149-151 St. Neots Road, Hardwick, Cambridge, CB3 7QJ, England. 
Fax. 0954 211607 Tel. 0954 211472 


[Acme 


| Coton Sofiware, Broadway House,149-151 St. Neots 
| Road, Hardwick, Cambridge CB3 7QJ, England. 
Fax; 0954 211607 Tel: 0954 211472 


Post code 


from PipeUraam 3.10 Lingemwity's Presenter 2 and then loading the resulting graph 


Introducing C 


Part 8: Command line arguments, dynamic 
memory allocation and bit variables. 


by Dec McSweeney 


COMMAND LINE ARGUMENTS 
The complex topic of using C to interface 
with the Desktop will be tackled at length in 
a forthcoming series of articles. In the 
meantime I will explain the more 
conventional way of invoking C programs. 
This involves typing the name of the 
program at the * prompt, for example: 


*myprog argl arg? 


This would cause the program ‘myprog’ 
to be loaded and run (provided it existed in 
the current directory or the library). Argl 
and arg2 are ‘command line arguments, 
which are passed to the program by the 
operating system. But how does the 
program get hold of them? 


Up to now, when example programs have 
appeared in this series, the function main 
has been followed by empty parentheses or 
the word void. However, main can have two 
arguments. The first is an argument count, 
the second an array of char pointers, each 
pointing to a word on the command line. By 
convention, these two arguments are known 
as arge and argu respectively, and who am I 
to fight convention? The full prototype of 
main now reads: 


<type> main(int argc, char *argv[]) 


contents of arguv/0] will always be the 
program name as entered at the keyboard. 
This allows you to detect if the directory 
path was used, if you really want to know 
(and I dare say there’s scope for a spot of 
software protection here). A word is defined 
as a string of characters bounded by 
unquoted white space. Thus: 


myprog hello mm /* arge = 3 */ 
but: 
myprog "hello mm" /* argc = 2 */ 


Successive entries in argu/] will point to 
successive words on the command line. As 
with most things, C trusts the programmer 
to stay within the bounds of the array. And 
here we come to another rich source of 
errors in C programs; the number of 
arguments after the command line and 
subsequent program name (held in argu/0/) 
is thus one less than argc as : the first 
effective argument is argu/1] and the last is 
argvfarge-1]. I’ve told you now, so don’t 
blame me! 


Here’s a brief example of a program 
which takes arguments: 


where <type> would be 
void or int or whatever. /* 


|/* calc.c - prints the result of arithmetic expression in */ 
arguments 1-3, e.g. calc 75 / 15 would print 5 */ 


The second argument, by | /* 


the way, reads “an array 
argv[] of type ‘char *’”. 
Mastering the art of 
interpreting complex 
declarations is an 
achievement of no small 
difficulty - take my advice 
and stick to the simple 
ones wherever possible). 


arge will always be at 
least 1, in the case where 
the only word on the 
command line is the 
program name. Thus, the 
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#include <stdio.h> 

finclude <string.h> 

#include <stdlib.h> 

int main(int argc, char *argv[]) 
{ 
int opl, op2; 


Af(arge != 4){ 
fprintf(stderr, "Wrong number of arguments\n"); 
exit (1); 
} 


opl = atoi(argv[1]); 
/* function atoi(str) returns int value of string */ 


Written by Dec McSweeney 1991 */ 


Cont. overleaf 
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op2 = atoi (argv[3]}) ; 


switch (*argv[2}) { 


‘els 
printf ("td\n", opl + op2); 
break 


printf ("td\n", opl - op2); 
break; 


print£("#d\n", opl * op2) ; 
"ys 
printf("#d\n", opl / op2); 
break; 


default: 


fprintf(stderr, "Unknown operation") ; 
break; 
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Note how the switch statement uses 
*argu/2], that is, the character pointed to by 
argv/2] (each entry in the array argu/] is a 
pointer of type char remember), while atoi 
takes as arguments the pointers themselves. 


If you’re getting the hang of C you could 
try amending the program to take real 
arguments, using atof{) instead of atoi. The 
program ought to check argu/3/ for zero 
before dividing, and if you can include sqt 
from part 1 you can have a gold star this 
month! 


The arguments above are positional, 
that is they must appear in a fixed sequence 
and their meaning to the program is 
indicated by their position. More normally, 
at least some of the arguments will not be 
order-dependent and in the case of a 
program with many options could be quite 
numerous - think about writing a C version 
of the RISC OS *COPY command. 


The usual way to handle such a situation is 
to process each argument in turn using a for 
loop: 


for(n=1; n<argo; nt+) { 
/* ... argv[n] processing .. */ 
} 


Observe that n starts at 1, but the 
terminating condition is n<arge, so the last 


iteration processes argu/argce-1]. For a 
command like *COPY the first two 
arguments would be positional (and 
compulsory), but the remainder could 
appear in any order. In such a case the 
program would validate for at least two 
arguments (arge >= 3) and the for loop 
would start at the first optional argument. 
Optional parameters should be set to their 
defaults first, then reset if mentioned in the 
command invocation. Mandatory 
parameters can be set to invalid values first, 
then checked for valid values after all the 
arguments have been processed. 


SOME USEFUL FUNCTIONS 


The standard C library contains a large 
number of useful functions. Many, such as 
the input and output routines, have 
already been discussed. One group of 
functions that has not been covered is 
concerned with the dynamic allocation of 
memory. 


In a multi-user operating system such as 
UNIX, or a multi-program environment 
such as RISC OS, it is important that 
programs do not take up more memory than 
necessary. If your word processor is to be 
used for a short letter, it doesn’t need 
enough memory to store a novel (1st Word 
Plus please note!). In the same way, it is 
frustrating if a program imposes 
unnecessary limitations on the user. One 
popular word processor runs on the IBM PC 
(a 640K machine), but will only cope with 
documents of up to 32K! 


The easiest way to cope with this 
problem is to provide the program with 
memory when it needs it, and to claim it 
back when the program finishes with it. The 
functions malloc() and free() provide this 
facility. 


The full prototype of malloc is: 
void *malloc(size t s); 


This means that malloc returns a pointer of 
type void. A void pointer is simply a 
mechanism for converting pointers from one 
type to another using casting. So, if the 
memory is required for a character array, 
the function would be called thus: 
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char *str; 
size t array size; 

/* set array size to the required value before malloc */ 
str = (char *)malloc(array size); 


If a block needs to be enlarged, 
the function realloc will attempt to 
provide extra space. This may 
involve a malloc for the new size 


numbers=(int *)malloc(1000 * sizeof (int)) ; 


Remember that size_t is an imple- 


followed by a copy, so the value of 
the pointer may change: 


mentation-defined variable type which 
is used for variable sizes. The C function 
sizeof() is useful when using malloc: 


/* A portable call to claim space for 1000 integers */ 
/* The size of type int varies from machine to machine */ 
int *numbers; 


If malloc cannot claim sufficient space from 
the operating system it will return a null 
pointer. 


The structures discussed in part 6 are 
ideally suited to the use of malloc. A typical 
structure representing a block of text in a 
word processor might look like this: 


struct block { 
char *text; 
struct *block prev; 
struct *block next; 
hi 


struct *block bptr; 


To claim more memory as extra lines are 


added: 


new block = (char *)realloc(bptr->text, new size); | 
if (newblock != NULL) 
bptr->text = new block; 


of these 


One 


limitation 
standard functions is that the 


spare memory can _ become 
fragmented, and while there may 
be sufficient memory there may not 
be a large enough contiguous 
chunk to service a request. 


Furthermore, Acorn’s implementation 
provides memory from the amount allocated 
in the program’s original Wimpslot. Once 
this is used up, malloc will return null 
pointers (implying no more memory), no 
matter how much there may actually be. 
RISC OS applications may use a family of 
functions found in flex.h and heap.h which 
sidestep these problems (but reduce 
portability). 


BIT VARIABLES 

If you use flags extensively in your 
programs and you’re coming from an 
assembler background, you might not like 
the idea of using a whole integer (4 bytes in 
Acornsoft C) to store a simple yes- 


bptr->next = (struct block *)malloc(sizeof (struct block) ); 
/* link the new block to the chain */ 

bptr->next->prev = bptr; 

bptr=bprt->next ; 

[Pree aoe = NULL; /* this is the end of the chain */ 


no value. If your programs are 
huge, you might not have room! In 
a well designed language it should 
be possible to store a flag in a 
single bit, and this is true in C. 


Once the size of the block is established, 
malloc can be used to allocate the text area: 


One approach is to use #define to set up 
bit-values. Returning to the *COPY 
example, options could be defined as powers 


size t block size; 


bptr->text = (char *)malloc(block size) ; 


of 2, corresponding to a bit: 


fdefine FORCE_OVERHRITE 1 


define DELETE SOURCE 2 


To release a block of memory, the 
function free() is used: 


fidefine VERBOSE 4 


/* .., and so on */ 


int options; 


free (bptr->text) ; 
/* unlink from the chain */ 


To set a flag, write: 


bptr->next->prev = bptr->next; 
bptr->prev->next = bptr->prev; free (bptr) ; 


options |= VERBOSE; /* 


'I" is the bitwise OR */_ 
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To unset it, use: 


| options &= “VERBOSE; 


/* ‘6! ds the bitwise AND */— 


names will be unique to the compiler - 
in this case Acornsoft’s ANSI C 
release 3. The principles will apply to 


This uses a new operator: the tilde (~) which 
means NOT in bitwise operations. Note also 
the use of the <op>= shorthand. 


To test such a flag, you would write: 


if((options & VERBOSE) == 0) 
/* 4.e. if VERBOSE is off */ 


However, C allows you to define a structure 
containing bit-fields: 


struct { 
unsigned int force overwrite : 1; 
unsigned int delete source : 1; 
unsigned int verbose : 1; 
} copy_options; 


The width of the field in bits is specified 
by the number after the colon. In this 
example, copy_options contains three one-bit 
fields which you can access in the same way 
as any other structure member. For 
example: 


copy_options.verbose = 1; 
if (copy_options.delete source = 0) 


You should check your compiler’s 
documentation for information about the 
way bit fields are implemented. Such factors 
as alignment and order of allocation will 
vary from one compiler to another. In 
Acornsoft C, for example, copy_options 
would occupy an int and force_overwrite 
would occupy the least significant bit. For 
the sake of portability you should not rely 
on a particular compiler’s foibles. 


USING SWIs 

A feature of the Archimedes is the well 
documented interface to operating system 
routines. In Basic this is achieved with the 
SYS command, in assembler, SWI. Of 
course, C also provides a way of accessing 
them. Naturally enough, what follows is 
specific to RISC OS machines, and the 
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any compiler. 


A header file, kernel.h, contains function 
prototypes, #defines and other relevant 
data, but there are possibly better 
alternatives in RISC_OSLib (see the future 
series on programming the Wimp in C), 
which contains many ‘packaged’ SWIs. 


Information is passed to and from SWI 
routines in the registers 0-9. These are 
defined as a structure _kernel_swi_regs in 
the kernel.h file. In your program you 
should include the following lines: 


#include <kernel.h> 
_kernel_swi_regs my regs; 


Individual registers are treated as ints and 
accessed as in this example: 


myregs.r[4] = 1099; 


Registers are often used to hold the 
addresses of (or pointers to) character 
strings or other blocks of data. C is well- 
suited to this requirement. The address of 
any variable is given by the operator &, or 
in the case of arrays by the unsubscripted 
array name: 


char message [50]; 
struct line data edit line; 


my regs.r[0] = (int)message; 


my _regs.r[0] = (int) edit line; 


Pointers are cast as integers, which is the 
type of the register array elements. You can 
even pass the address of a “character 
constant” or “string literal”: 


my _regs.r[0] = (int) "This is a literal"; 


To actually call a SWI, use the routine 
_kernel_swi: 
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_kernel_swi(int swi_number, kernel_swi_regs *in, _kernel_swi_regs *out) — 


The SWI numbers are #defined in swis.h so 
you can refer to them by their names, for 
example: 


detail 


This topic will be 
covered in con- 
siderably more 


in a forthcoming series on 
programming the Desktop in C. In the 
meantime, here is a short program to 


- display any portion of the time/date 


#include <swis.b> 


UNIX utility “date”. 
_kernel_swi(0S_ReadVarVal, émy regs, émy regs); 
/** date.c - print any portion of the "Time" message in any ae/ 
/** specified format (see PRM for key) an/ 
/** Example: date "$WE, &MO the $DY%ST”" would print oe/ 
/** “Tuesday, December the 25th" an / 
/** Made in England by Dec McSweeney, programmer to the gentry **/ 


finclude <stdio.h> 

finclude <stdlib.h> 

#include <kernel.h> 

#include <swis.h> 

int main(int argc, char *argv[]) 


{ 

char pblock[5]; 
char outstring[50] ; 
int n; 
_kernel_swi_regs r; 


/** First a call to 0S Word 14, 3 - read clock as 5-byte value **/ 


/** 20 = 14, rl = address of parameter block (to hold result) 
/** on entry, lst byte of rl is set to 3 (the “reason code") 


r.x[0)=14; 
r.r[1)=(int) pblock; 


pblock[0] = 3; 
_kernel_swi(0S Word, &r, ér); 


*/ 
*t/ 


/** on exit, pblock holds the 5-byte time - compare with a Basic **/ 


/** command "SYS 07, 14, pblock TO , pblock” 
/** first we show the contents of pblock.... 


for(n=0; n < 5; nt+) 
print£("#02x ", pblock[n]); printf("\n"); 


/** Now, we call SWI 6C1 to convert. argv[1] is the char array 


*8/ 


aa/ 


#*/ 


/** holding the format string. For this call the 5-byte block is **/ 


/** addressed via r0, the output string via rl, the format 
/** string via r3. The length of output array is in r2. 


r.xr(0)=x.r[1]; 

r.r[1)=(int) outstring; 

r.x[2)=50; 

r.2[3]=(int) argv[1]); _kernel_swi(OS ConvertDateAndTime, ér, ér); 
print£("ts\n", outstring) ; 

exit (0); 

} 


ae] 


an] 


display, in much the same way as the 


As it stands, the 
program will fall over 
if there is no format 
string in argv/1], and 
does no validation on 
the format, so it relies 
on OS_ConvertDate 
AndTime to cope with 
any rubbish the user 
might type. 


Now you know 
how to do it, why 
not change date.c to 
report an error if no 
argument is present, 
or even to use a 
default string - 
clever types could 
use OS_ReadVarVal 
to access 
SYS$DateFormat, 
or call OS_Convert 
StandardDate 
AndTime (SYS &60) 
which uses 
SYS$DateFormat 
instead of r3. A really 
user-friendly version 
would print helpful 
information if argu/1] 
was missing, invalid or 
set to “?”, 


Have fun! 


That’s it for this 
month. Next time I 
hope to wrap up the 
series by tidying up a 
few loose ends and 
taking a look at the 
compiler. 


AU 
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MORLEY §.L.£.C.7.R. 


NEW IN STOCK 


A3000 £599 
410/1 £1099 
420/1 £1699 
440/1 £2099 


Learning Curve £699 


Archimedes} 


THE WORLDS 
MOST POWERFUL 
MICRO 


SPECIAL OFFER 
Buy an A3000 and get an 
extra 1MB RAM fitted for 
only £50 or a free A3000 

Analogue & User Port 


Podule. Buy a 410 and get 


an extra 1MB RAM free 


ARCHIMEDES PERIPHERALS 


Colour Monitor £199 
Mono Monitor £73 
A3000 

Monitor Stand £29 
User Port & Midi Pod. £49 
Serial Upgrade £19 
Econet Upgrade £49 


ARCHIMEDES 


Pipedream3 £147 
RiscOs Companion £49 
ist Word + £69 
Autodesk CAD £79 
Acorn PC Emulator £99 
Acorn Desktop Pub £149 
Clares ProArtisan £145 
Clares Artisan £29 
Clares Toolkit £34 
Clares Toolkit + £43 


300/400 SERIES 

Acorn Rom Podule £56 
2 Slot Backplane £37 
4 Slot Backplane £59 
/O Podule £80 
Midi Podule £65 
Second 3.5" Drive £115 


SOFTWARE 


This is a small 
selection of the 
software that we 
can supply at 
competitive prices. 
Please call for 
any item you 
require. 


TELETEXT 


THE BIGGEST 
SELLING ADAPTER 


The Morley Teletext Adapter 
is now available for the 
Archimedes. Advanced 
specifications, include digital 
tuning, screen dumps etc. 
Connects via the external 
podule socket or our 
Analogue/User Port £125 


Existing users of our BBC 
Teletext Adapter can have 
the unit converted to an 
Archimedes version for£35 


FURTHER INFORMATION 


Our new catalogue will be available from mid August. We 
can also supply data sheets for most products. Please call 


or write if you require any of these. 


MICROVITEC 
CUB3000 
MONITOR 

£199 
INCLUDING 
CABLES 


This is the new monitor from Microvitec that has been specially 
designed for use with all Archimedes computers. It comes 
in a rugged colour matched metal case with controls for 
brightness, contrast and volume. The picture quality is very 
good and all the required cables are included in the price. 


A3000 3.5" 
SECOND DRIVE 
A 


The kit consists of a 3.5 
inch floppy disc drive, data 
cable, power cable, metal 
case (cream coloured), an 
interface carrier board and 


The kit and assembly are 
similar to our 3.5” kit except 
the case is larger and the 
mechanism is a high quality 
TEAC 5.25” drive. The drive 
(unlike some you can buy) 
is also buffered to Acorn 
specifications so eliminating 
the possibility of damage to 
your A3000 (buffering is not 
required for an additional 3.5° 
drive). 

£169 


LEADS & MISC. 


SCART Monitor Lead £8 
9 Way Msync Lead £8 
Arch Serial Lead £8 
Printer Lead £6 
2 to 1 Printer switch £20 
3 to 1 Printer switch £30 
4to 1 Printer switch £36 
64k Printer Buffer £115 
256k Printer Buffer £199 


full fitting instructions. 
You will be required to take 
the current drive out of the 
A3000 and replace it with 
the interface carrier board 
(unlike some add-on drives, 
you Can still use your internal 
podule socket). The original 
drive then fixes in the case 
with the second drive and 
the case is connected to 
the A3000 with two cables. 
As the connectors are 
detachable, the unit can be 
easily disconnected from the 
computer if the need arises. 
£125 


A3000 5.25" 
SECOND DRIVE 


HARDWARE 


80 col Printer Stand £15 
132 col Printer Stand £19 
A3000 Monitor Stand £29 
Tilt & Swivel Stand £11 
Eprom Eraser £18 
Eraser with Timer £23 
5.25” Discs x 10 £5 
3.5" Discs x 10 £10 
27128 Eproms £4.20 


O.N.1.C.S. L.T.D 


MEMORY EXPANSION 


THE BEST VALUE MEMORY UPGRADES 


Unlike most other upgrades, our 1MB 
upgradeable card can be upgraded 
with another 2MB (4MB total in 

machine) at a later date for maximum 

flexibility. Futhermore, our card can be 
upgraded without throwing away the 
memory that you already have on the 
card, 


A3000 1 MB Expandable £99 
A3000 1 MB Non-Expandable £89 


A3000 3 MB Upgrade £259 

A3000 1 MB to 3 MB (free fitting) £180 ~ Fully compatible with all Acorn software. 
305 1/2 MB £89 - A must for all serious Archimedes owners. 
400 Series 1 MB £99 - Make full use of powerful RISC-OS packages. 


400 Series 3 MB £249 - Can use extra RAM as a second drive. 


*** NEW PRODUCT *** 
A3000 BBC Analogue + User Port Podule 


Full specification BBC analogue and user 
port. The analogue port is accessible 
using ADVAL from BASICS with ail 
BBC OSbyte calls supported. 
£69 
Interface software written by 
Acorn for maximum 


compatibility with the BBC. 


HARD DISK DRIVES 


SCSI HARD 
DISK DRIVES 


INTERFACES 


A3000 SCSI Pod. £149 
300/400 SCSI Pod.£199 


ARCHIMEDES 


eee NEW et 
A3000 HARD DISK DRIVE UNIT 


INTERFACE 
ST506 Podule Kit £149 


DISK DRIVES 


Including ST506 Podule, 
cased drive with power 
supply, cable & leads 


SCSI DISK DRIVES 


Including SCSI Podule, 
drive, cable & leads. 
A3000 drives also 
include case and power 
supply. 


A3000 20MB 
A3000 30MB 
A3000 40MB 
300/400 20MB 
300/400 30MB £489 
300/400 40MB £569 


Please call for prices on 
larger drives for A3000 
or 300/400 


20MB £399 
40MB £499 
Larger Drives POA 


Compatible with Acor's ADFS. 16 bit 
interface for extra speed. Drive mounted 
in separate colour coordinated case with 
switched mode power supply and fan. 
Complies with Acom'‘s new 
recommendations on RF emissions. 


£465 
£495 
£575 
£449 


“A 


MORLEY 


E.L.E.C.T.R.O.N.1.C.S. L.T.D 


Morley House 
West Chirton 
North Shields 
Tyne & Wear 
NE29 7TY 


Tel (091) 257 6355 
Fax (091) 257 6373 


Shop hours: 
9am to 5:30pm (Mon- 
Fri) Sam to 4pm (Sat) 


a 
Acorn 


We are an Acorn dealer and 
service centre. If you would 
like to have a look at the 
A3000 or any other Acorn/ 
Morley product please feel 
free to call in and discuss 
your requirements with our 
staff. 


if there is 
anything you 
require which isn't 
advertised, please 
ring for a 
competitive 
quote. 


How To Order.... 


BY POST: Enclose cheque 
made payable to MORLEY 
ELECTRONICS LTD. 


BY PHONE: By quoting your 
ACCESS or VISA card 
number, 


CARRIAGE: £1 on most 
orders, £3 on larger items. 
Hard Disks, Computers + 
Monitors £10 (carrier). 


VAT: UK customers please 


add 15% to cost incl. 
carriage. 


GOODS USUALLY 
DESPATCHED BY RETURN. 


Government and Education 
orders welcome. 


Acorn and Archimedes are 
trademarks of Acorn 
Computers Ltd. 
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INSTANT SPRITE DISPLAY Basic will give the usual “Press SPACE or click 


Lee Calcraft mouse to continue” message. The command 


When editing an application sprite, you can 
have trouble seeing the effect of your work. 
Even once you have saved the new sprite, the 
old one will still be displayed as the icon for 
your application in its directory viewer. This is 
because the Wimp sprite pool still holds a copy 
of the unedited sprite. 


To update the Wimp sprite pool (without having 
to resort to a hard Break), use F12 to get to the 
command line star prompt, and issue: 
*IconSprites <pathname> 

where <pathname> is the full path to the 
application’s !Sprites file, for example 
adfs::0.$.!MyApp.!Sprites. The new image will 
appear as soon as you return to the Desktop 
(by pressing Return). 


SHELLCLI IN USE 


Matthew Astley 


On some occasions, the ShellCLI module (which 
allows you to invoke a command shell from a 
Wimp program) can give the error “ShellCLI in 
use”, and is unusable until after the next reset. 
There does not seem to be any way of retrieving 
it, but an alternative is available - from the 
Task Manager, select New task from the menu 
and enter the star command you wish to issue. 
This can either be a one-off command, such as a 
compilation command or disc catalogue 
command, or a *GOS to go to the Supervisor. 
This is like the ShellCLI, except that you have 
to exit with *Quit. 


USING ALIAS$SHELLCLI 
Matthew Astley 


The key F12 from the Desktop can be put to 
other uses. Whenever it is pressed, the Task 
Manager issues a *ShellCLI. If the system 
variable Alias$ShellCLI is set, that command 
is used. For example: 

*Set Alias$ShellCLI FX 138 0 130|M%Shel 

1CLI|M 
would “press” key F2 and then go into the 
ShellCLI as normal, but the string contained 
in Key$2 will be “typed” for you. If the 
ShellCLI is in use, or you prefer to go into 
Basic when you press F 12, use: 

*Set Alias$ShellCLI Echo ||2/|_|/@|{* 

| |J|MBasic|M 
The Echo command (up to the first |M) puts a 
blank line at the bottom of the screen (but also 
creates a dialogue window in the middle of the 
screen), and then jumps into Basic. QUIT from 
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*%ShellCLI sends the ShellCLI command to 
the original ShellCLI module, as in the first 
example. 


MORE USES FOR ADJUST 

Lee Calcraft 
If you click on the title bar of a window with the 
Adjust button, you can move the window around 
without bringing it to the front of the stack. 
Moreover you can continue to move a window 
beneath another even though you cannot see the 
window that you are moving. Adjust can also be 
used on the adjust size icon without bringing 
the window to the top of the stack. 


FONTS AND VOICES 

Tony Shew 
The RISC User monthly disc for Volume 3 
Issue 3 contained several system fonts, and 
many more can be obtained “free” by searching 
through games discs (but you must not 
contravene copyright by distributing these). 
The filetype may need to be changed to FF7 
(BBC font). Games discs are also a good source 
of sound voice modules. 


SUB-MENUS IN C 

David Spencer 
If you are using the ANSI C compiler with 
RISC OS Lib to create a menu tree involving 
more than two levels of menu, you must attach 
the sub-menus in reverse order. For example if 
you have a tree of the form: 

Menu 
Sub-menu level 1 
Sub-menu level 2 

you must attach the level 2 sub-menu before 
attaching the level 1 sub-menu, or the task will 
misbehave when the menus are opened. 


PRINT TO FILE 

Alan Wrigley 
OS_Byte 5 (or *FX5,n) sets the driver type for 
subsequent printer output (this can also be 
configured using *Configure Print n). The 
second parameter of the call, or the value of n in 
the *Configure command, is 1 for the parallel 
port and 2 for the serial port, just as on the BBC 
micro. However, if this parameter is greater 
than 2, RISC OS looks for a system variable 
with the name PrinterType$n (for example, the 
NetPrint module defines PrinterType$4). To 
divert printer output to a file therefore, set up a 
variable as in the following example: 
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. *Set PrinterType$5 adfs::HardDisc.$.0dd 
bits.Printout 

Then use *FX5,5 to send any subsequent 
printer output to the specified file. This is very 
useful for testing printed output from your 
programs without generating reams of scrap 
paper. The file thus produced can be loaded 
into Edit for inspection. 


DRAWING STRAIGHT LINES 

vor Clarke 
Drawing a straight line in Movie Maker, or 
indeed any drawing package in freehand mode, 
can be very tricky. However, by running the 
mouse along the edge of a box, a straight line 
can be drawn quite easily. Diagonal lines can 
be drawn by using the corner of the mouse on 
the straight edge. 


CONDITIONAL FUNCTION 
EXECUTION IN C 
Lee Calcraft 
In C the following line will only cause myfunc() 
to be executed if flag is false: 
if (flag || myfunc()) i++; 
The contrary is true in Basic: 
IF flag OR FNmyfunc THEN it=1 
Here FNmyfunc will be executed regardless of 
whether its value is to be used or not. Here C 
appears to behave more efficiently than Basic, 
since if flag is TRUE, the value of FNmyfunc is 
irrelevant. 


A similar thing occurs with the AND operator: 
if (flag && i++) j++; 

Here i will only be incremented if flag is 

TRUE, since only in that case is there any 

need to look at i at all. Again Basic will look at 

all the elements in the logical expression. 


IMPROVING PRINTERDM FOR THE 


STAR LC24 
A.F. Taylor 


Using the Star LC24-10 printer with DTP 
packages and also with Draw, I noticed an 


occasional and apparently random mis- 
registration between successive passes of the 
print head, producing a “slewing” of the line of 
text. I was using PrinterDM with the printer 
definition set to Epson LQ800 (the LC24 
claims LQ800 compatibility). Eventually I 
traced the problem to a slight incompatibility 
between the LC24 and the LQ800. 


This can be cured by a small amendment to the 
PrData file, under the section for Epson LQ800 
compatible (360 x 180 dpi). Simply amend the 
following line: 

line_epilogue "<27>$<0><0><27>J<24>" 
to read instead: 

line_epilogue “<27>A<0><13><27>2<27>J<2 
4>” 


OPENOUT AND FILETYPES 

Lee Calcraft 
It is sometimes convenient to set the type of a 
file used with the OPENOUT statement, and 
to do so before the file has been closed. To do 
this, create a file of the required name, and set 
its type using *SetType (or combine both 
operations with SYS “OS_File”,10), then use 
OPENOUT with the same filename. The filing 
system will open the new file using the file 
type used by the previous incarnation. 


FASTMOVE 

Leonard Hanson 
The FastMove module supplied on the 
magazine disc for Volume 3 Issue 7 is very 
useful for hard disc users. If you use the RISC 
User Dustbin, open up the !Dustbin directory 
and add the following line at the start of the 
'Run file: 

RMEnsure FastMove 0 RMLoad <Obey$Dir>.F 

Move 
Then save the FastMove module in the 
'Dustbin directory as FMove. This change will 
reduce the time taken when deleting files, 
since Dustbin moves files by *COPYing with 
the delete option set. RY 


« POINTS ARISING + POINTS ARISING + POINTS ARISING - 


PCOL 

Volume 3 Issue 5 (disc) 

Under rare circumstances, mostly with some 
longer programs, a fatal crash occurs when 
using PCol. An updated version of PCol, 
which will cure this problem, is included on 
this month’s magazine disc. 
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Introducing C (Part 8) 

Volume 4 Issue 3 

Note that the concluding element of the for 

loop on page 62 should be n-- (and not n- as 

it appeared - a result of subsequent 

processing). ayy 
AY 


63 


ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range of computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


If you have written any programs, completed or not, then we would like 
to hear from you. 


If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


If you have the ability fo program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D. Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


lf you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 


Postbag = 


GAMES 

In response to Mr.Craig’s letter on adventure 
games (RISC User Volume 4 Issue 2), please 
note that Magnetic Scrolls are alive and well 
on 071-403 4268 (they even answer the 
telephone as Magnetic Scrolls). With regard 
to the fatal bug in The Pawn it does exist, or 
at least it used to, as it has now been 
corrected. Users can send the original disc 
back to the publishers, Intermediates, 
P.O.Box 847, Harlow, Essex CM21 9PH, tel. 
(0279) 600204 for a replacement. 


One problem which persists, and which I 
hope Magnetic Scrolls has taken heed of, is 
that whenever the copy protection system 
asks for the word Kerovnia (probably once 
in every four times), it pretends not to 
understand the word, so saving fairly 
regularly is a good precaution. 


Mr.Craig does not mention any problems 
with Guild of Thieves, but I know for 
certain that there were a few which have 
been ironed out. The same rules for a 
replacement apply here as for The Pawn. 
One problem with all Magnetic Scrolls games 
to date is that they will not work with later 
versions of the C library module CLib than 
that supplied with the game, A simple 
solution is to press F12 and type: 
RMKill SharedCLibrary 

before running either game. Experienced 
users could probably alter the !Run file 
appropriately. 


With regard to the problems in completing 
the game, do not telephone Magnetic Scrolls 
because they enjoy keeping the solutions a 
secret. Do not write to me either because I’m 
not good at them. Instead join Official 
Secrets. This is a club primarily for 
Adventurers and is part of Intermediates. 
Club members enjoy the benefit of an 
adventure help line, and other assistance. 
The cost is £29.99 which includes a quarterly 
magazine, a bi-monthly glossy catalogue 
covering all games, and a choice of game 
from Fish!, Corruption, The Pawn, or 
Guild of Thieves. There is also a lower 
price Special Reserve membership without 
the help line for £6.00. 
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As a final note, watch out for Wonder-Land 

early this year, Magnetic Scrolls’ new 

adventure being published by Virgin. 
Nicholas Furness 


AND MORE GAMES 


Just a short letter to congratulate the writers 
of Twin World. What a masterpiece! The game 
is a joy to play from start to finish. Each 
evening when I get in from work I load up 
the game and try to improve on my final 
score of 55950. Never has such a great game 
been written for the Acorn range of machines. 
If this is what the standard of games 
programs on the Amiga is like, then where 
have the writers of Archimedes games gone 
wrong? 


Please, please, please can we have more 

games like this for the Archimedes. No time 

for any more, I still have the world to save! 
Neil Newman 


GERMANIA 


Alan Wrigley’s article in RISC User Volume 3 
Issue 10 is misleading with respect to the 
German keyboard. Every week my wife writes 
long letters to her mother in Germany. After 
loading Ist Word Plus, she presses F12 and 
types (at the star prompt): 

COUNTRY GERMANY 
Not only do the Z and Y change places but 
the entire keyboard adopts the German 
layout. The f is to the right of zero, U to the 
right of P, and O and A to the right of L. For 
a German touch typist there is no further 
problem. To change back to the normal state 
type: 

COUNTRY UK 
at the command line prompt, being careful 
not to type ‘COUNTR2Z’. Alternatively, simply 
reboot the machine. 

David Taylor 


Alan Wrigley replies, “Mr.Taylor is quite right 
about German characters. | thought | had 
tested both French and German before writing 
that particular paragraph in my article, but 
obviously | only tried it out with the French 
alphabet, which does not have provision for 
accents on the keyboard AU 


65 


310 colour with 4Mb RAM and 40 
Mb hard disc, CC ROM/RAM board, 
Acorn ANSI 'C', Programmers 
Reference manuals and software 
£1600. Tel. (0258) 45281 extn. 2209 
between 0900-1700. 


Story writing, artificial creativity. 
Postal discussion/programming 
group proposed. Tony Kelly, Can y 
Lloer, Ffarmers, Llanwrda, Dyfed. 


Canon PW1080-A printer as new 
with cable (cost £270) £90 plus 
carriage, Tel. (0275) 462979. 


Archimedes A3000 base with 
1Mb RAM and RISC OS, 3.5" 
floppy drive etc. for only £650 
(unwanted gift 1 month old!) Tel. 
(0246) 435555. 


Games Minipack No.2 from CIS. 
contains Corruption, Conqueror 
and Quazer, NB these are originals 
not copies (unwanted gift) £11 the 
lot. Tel. 081-654 3733, 


!Personal Accounts 
A3000/Arc Special Edition 


Version 2 : £28.95 


BBC B & Torch twin disc system 
with many packages, discs, 
magazines, books, cassette unit 
and light-pen ete. £250. Tel. (0304) 
853267. 


Archimedes 310 base unit with 
RISC OS, manuals, applications 
discs, 4 slot podule backplane £450. 
Tel. (058 283) 3773. 


Archimedes 310 computer with 
twin dise drive, colour monitor and 
software £600. Tel. (0743) 248107. 


Epson LQ2500 24 pin dot matrix 
printer with dual bin sheet feeder 
bargain at £350. Tel. 081-531 0716. 


Archimedes 410/1 8Mb RAM, 
50Mb hard disc, Geniscan A5 mono 
scanner, Taxan 795 monitor with 
VIDC, Linnet modem, manuals, 
lots of software. Offers in the region 
of £2200. Will split, also Cumana 
5,25” dise drives and modems £20 
each. Tel. 04867 80632. 


Personal Ads (free to members) 


Philips paper-white monitor, 
model BM7522, excellent condition 
with original packaging £55, Tel. 
061-969 9428. 


Complete workstation 1200mm 
bench, Master 128, colour monitor, 
LX800 printer, twin 5.25" Cumana 
drive, perfect condition £650. Tel. 
081-464 8276, 


Micro Peripherals MP165 
printer with NLQ facility, Epson 
compatible, hardly used (home 
environment only), complete with 
leads and manual etc. £100, Tel. 
(05086) 3517. 


Archimedes A3000 still under 
warranty, new games, manuals, 
software and magazines £575. Tel. 
051-489 9456. 


WANTED: Acorn Atom computer 
in good working condition. Tel. 091- 
374 3631 day, 091-372 1797 eves. 


ArceMonitor 
Professional disassembler, 10 breakpoints, 


Cambridge International Software Ltd 
8 Herbrand St London WCIN 1HZ 


071 833 4023 
£24.95 


* RiscOS Multi-Tasking Application 

* 28 Automatic Standing Orders/Any Period 

* 48 Income/Payment Headings with budget columns 
* 10 Bank/Credit/Cash Accounts on-line 

* 20 Quick Entry Pre-sets 

* 3000 Entries per File 

* 50 Character Description Space 

* Full Scrolling Entries for easy inpuVedit/search 

* Reports to Screen/Printer/File 

* Calculator/Note Pad/Autosave & Much More 


“Personal Accounts is very powerful, good value for 
money, easy to use and comes highly recommended” 
Review of Version 1, Archive, November 1990 


Apricote Studios 


2 Purls Bridge Farm, Manea, Cambs, PEIS OND 


[Aa] Tel: 035 478 432 arc 
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mouse driven, RM, + many features. 
Supersounds £17.95 

4 disks of 'raw' samples 

Minipack 5 £29.95 
contains FISH, PON & FIREBALL II 
Mah-Jong Patience £19.95 
Fiendish version of chinese patience with tiles. 
MicroDrive £19.95 


Much acclaimed 3D golf simulator. 


Crisis £17.95 
Maze game full of 'mIcons' and sounds. 
PIPP £49.95 
Cross-curricular project planner for Primary 
schools, Contains ALL AT statements. 
RiscType £19,95 
Archimedes Typing Tutor 
Fireball II 

World's greatest breakout game. 


£19.95 


VAT included please add £1 p & p. All cards accepted. 
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Technical Queries 


CREATING BOOT FILES 


Dear Sir, 

| have typed in a lot of your utilities 
and now have around 20 of them. The 
icon bar gets so full that | have to scroll 
it sideways to access everything. Is it 
possible to create a second icon bar 
which | can bring up by clicking on the 
original icon bar? 


Still on those utilities, | have to load 

them off my ‘system’ disc every time ! 

switch on. | have used !Boot Obey files 

with things like: 

*Desktop Run !Mouse 

and that works fine, for the first utility. 

Playing about with the !Boot file, | can 

get nothing more to happen. How do! 

get it to load, say, 20 Wimp programs 

and enter the Desktop properly? 
Richard Murray 


First of all, it is just not possible to create 
another icon bar. It is possible to change 
the height of the existing icon bar, but this 
still doesn’t help as all applications so 
installed must occupy a unique position 
along the length of the icon bar. 


However, it is perfectly possible to create a 
boot system which will achieve what you 
seek, and load and install 20 Wimp 
programs leaving you in the Desktop, but 
this cannot be done with a single file. 
What you need to do is to create an 
application on your ‘system’ disc called 
!Boot. Next use Edit to create a !Run file, 
to be saved in this application directory. 
Use this to set up any system variables (to 
set font path, run types etc.), and then 
enter as the last line of the !Run file: 
Desktop -file <Boot$Dir>.Deskboot 
assuming that Boot$Dir has been set to 
<Obey$Dir> earlier. 


Then create a text file (filetype FFF) called 
DeskBoot with lines similar to: 

Run adfs::SystemDise.$.!Edit 

Run adfs::SystemDisc.$.!Paint 

Run adfs::SystemDisc.$.!Draw 
ete. 
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finishing off with the line: 

Filer OpenDir adfs::SystemDisc.$ 
if you want to finish with the directory 
viewer for the root directory open on the 
Desktop. Finally don’t forget to set the 


auto-boot option on the disc to: 
*OPT4, 2 
Alan Wrigley 
RISC OS EXTRAS 
Dear Sir, 


My Investigations revealed the 
ReadMe file in the !System directory of 
the Volume 3 Special Disc which refers 
to RISC OS 2.00 Extras. | checked to 
find if these had been reviewed in RISC 
User but could find no reference. What 
emphasis do you place on having these 
‘Extras’ installed? 

Geoff Steeper 


Where newer versions of modules or 
additional modules are required we 
include an appropriate copy of !System on 
RISC User magazine discs, and other discs 
(like the Volume 3 Special Disc) which we 
publish. A condition of Acorn allowing this 
is that the ReadMe file referred to by 
Mr.Steeper has to be included, though not 
all the items referred to are themselves 
included. 


Effectively, these extras are updated 
versions of some of the applications and 
other modules supplied on the Applications 
discs with any Archimedes. By and large, 
if you are not encountering any problems 
then there is no great incentive to upgrade. 
The extras were referred to briefly in RISC 
User Volume 2 Issue 10, and published 
(with Acorn’s permission) on the RISC 
User magazine discs for Volume 3 Issues 1 
& 2. They are also available through SID, 
Acorn’s on-line bulletin board, and on the 
RISC OS Extras disc from BEEBUG for 
£4.40 plus 60p p&p. In addition, as already 
stated, the latest modules from !System 
are often included on other discs when 
required. 

Mike Williams 


AY 
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Software for 


ShowPage is a PostScript compatible 
interpreter running under RISC OS. 

Over the last 6 years PostScript has 
established itself as an industry standard 
graphics programming language. 
Pioneered by Adobe for use in the 
original Apple laser printers, it is now 
used in all manner of output devices 
such as colour printers, and typesetting 
machines 

ShowPage will be attractive to those 
wanting to learn and explore this 
programming language and those 
wanting to print and use PostScript files 
from other machines. 

ShowPage is fully multi-tasking and 
RISC OS compatible. It can read any 
PostScript file and output either to a 
window on screen, or to the currently 
selected RISC OS printer. It can 
therefore be used to make even the 
lowest cost dot-matrix printer PostScript 
compatible. When used in conjunction 
with LaserDirect, it can turn this printer 
into a very fast and fully fledged 
PostScript compatible laser printer. 

ShowPage supports the colour 


extensions and can create a sprite file of 


any required size. It can therefore be 
used to incorporate PostScript graphics 
into other RISC OS applications. It uses 
the RISC OS outline fonts, rather than 
the conventional PostScript fonts, for all 


PostSenpt ts a trademark of Adobe Systems inc 


rendering, so it is 
compatible with the 

wide range of Archimedes outline fonts 
now available for this computer, 

ShowPage has a simple built in editor 
allowing PostScript programs to be entered 
directly, and interactively with the results 
shown on screen in another window. 

Showpage is compatible with the 
output from Acorn PostScript printer 
drivers. Minimum recommended memory is 

2Mbytes. 
£149+VAT (£171 aes) 
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Package includes a spiral bound manual detailing the 

SbhowPage version of the language. 320 page PostScript 

language reference manual by Adobe. 240 page PostScript 

language tutorial manual by Adobe. Discs containing 

Sbow Page and example programs. AvantG, BookM, 

Pembroke RISC OS outline fonts. 
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An equation building tool that 
complements many RISC OS applications, in 
particular DTP and word processor programs 
such as Impression and Impression Junior. 

Many users of the Archimedes have a 
need to include complex mathematical 
formulae or equations into documents. 
Equasor allows equations to be built up on 
screen, graphically, from their component 
parts. Using the Acorn outline font system it 
presents a totally accurate view of the final 
equation at all times. 

It simplifies the building of equations by 
presenting palettes of symbols, functions and 
operators which can be selected just by 
clicking with the mouse. It intelligently scales 
and re-sizes features such as summation 
symbols, brackets, and square roots as the 
equation is edited so they are always the right 
size. 

Once the equation has been created it 
can be saved or exported to any number of 
compatible RISC OS applications. In DTP 
packages it can be dropped into frames just 
like any other drawing where it can then be 
scaled and positioned as required. 

When used in conjunction with 
Impression II, it can take advantage of the 
latter's embedded frame capability to embed 

Sie 
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L494+VAT (£56.35 incl.) 


equations into the text, even on the line. 
Once embedded in this way, the equation 
will then flow with the text as part of the 
text. 


Features: 


Multi-tasking RISC OS application. Supports 
direct in-memory transfer of equations for the 
fastest, simplest integration with other RISC 
OS applications, Any number of equations can 
be handled at the same time. Equations can 
be viewed and edited at any scale. Saves 
equations as Drawfiles compatible with all 
applications that support this format. Supports 
multiple different RISC OS outline fonts and so 
is not limited to the Math/Greek font supplied. 


¢ Supports region selection and cut, copy, 
paste between equations and 
documents. 


¢ Styles for global control over fonts, size, 
spacing etc. of variables and 
operators.Effects give additional control 
over the appearance of individual parts 
of an equation. 


* Small, compact program perfectly 
suitable for 1 Mbyte machines. 


Package includes a 60 page spiral bound 
manual with detailed tutorial reference, and 
index. Discs include the program, example 
equations, and Math/Greek outline font. 


Computer Concepts Ltd 
Gaddesden Place * Hemel Hempstead * Herts * HP2 6EX © Tel. 0442 63933 © Fax 0442 231639. 
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Special Offers to RISC User Members - Mar 1991 


Each month RISC User will include a list of special prices for BEEBUG's own Archimedes software, 
available only to RISC User members. 


Code Product Members’ Price inc.VAT Code Product Members' Price inc. VAT 
1406a_ Volume 3 Special Disc 9.95 , 0104a DFS Reader RISC OS upgrade ~— 2.40 
PDA1 Desktop Applications 9.95 
PAOM ArcOmnibus Games 9.95 | 0106c Hard Disc Companion 35.00 

0101d Hearsay 51.75 

PAS3a_ ArcScan Ill (complete) 14.95 0103a Hearsay RISC OS upgrade 4.40 

PAU3a_ ArcScan Ill (upgrade) 4.75 0107¢ ISOC Dev.$ 79.00 
(on return of ArcScan Il disc) Cc ev. System . 

. 0100c_ Masterfile Archimedes 16.50 

1410a_ RISC User Movie Maker 4.75 0111b Outline Font Pack 1 49.50 

1401a_ RISC User Toolbox (Arch.) 5.75 | 0108d Ovation (Beebug DTP) 99.00 

2420b RISC User Binders 4.20 | 0796c Serial Link 17.25 
0102b DFS reader 9. 90 0105a_ Serial Link RISC OS ae POOGS 2.40 


OTHER MEMBERS’ OFFERS 


These offers are available for one month from publication. 


aser Printers 
We have a number of 
ex-demonstration Qume and 
Panasonic Laser printers available at 
highly reduced prices. 


Please phone for up to date 
information on prices and 
availability: 


St. Albans (0727) 40303 


Offer price £52.00 (inc VAT) + £1.50 p&p 
(Save over £14.00 on normal BEEBUG price) 


This popular application from Minerva allows you 
to build up family history data, including scanned 
images where appropriate, for display and 
printout. 


Stock Code 0957b 


Compiler (Dabs Press) 
Offer price £66.00 (inc VAT) + £1.50 p&p 
(Save over £17.00 on normal BEEBUG price) 


Offer price £7.95 (inc VAT) + £0.60 p&p 
(Save £3.50 on normal BEEBUG price) 


This Basic compiler enables a program written in 
Basic to be compiled into assembly language for 

faster execution and more efficient use of money. 
Supplied complete with Runtime library. 


High quality 3.5" discs from a well known 
manufacturer supplied complete in a smart and 
convenient case. 


Stock Code 0675a Stock Code 0938b 
Previous items still on offer subject to availability: 


lo per's Tool Ibox 


Offer price £18.95 (inc VAT) + £1.50 p&p 
Stock Code 1083b 


Offer Ss ‘529. 95 (inc VAT) + £3.50 p&p 
Stock Code 0918d 


